Documentation Index Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
Use this file to discover all available pages before exploring further.
Запрос статуса выполнения и результатов асинхронной задачи генерации изображений
Обновление статуса и отслеживание прогресса в реальном времени
Получение сгенерированных изображений при завершении задачи
Поддержка многоязычности (zh/en/ko/ja)
Все задачи генерации изображений выполняются асинхронно. После отправки задачи необходимо запросить статус и результаты через API запроса.
Авторизация
Все эндпоинты требуют аутентификации Bearer Token Получить API ключ: Посетите Страницу управления API ключами для получения API ключа Добавьте в заголовок запроса: Authorization: Bearer YOUR_API_KEY
Параметры пути
ID задачи, возвращенный API генерации изображений
curl --request GET \
--url 'https://toapis.com/v1/images/generations/task_01KA040M0HP1GJWBJYZMKX1XS1' \
--header 'Authorization: Bearer <token>'
200 - Обрабатывается
200 - Завершено
200 - Ошибка
404
401
{
"id" : "img_5b8b19afe5c24ab3a92df996f1a33931" ,
"object" : "generation.task" ,
"model" : "gemini-3-pro-image-preview" ,
"status" : "in_progress" ,
"progress" : 50 ,
"created_at" : 1768381010
}
Ответ
Уникальный идентификатор задачи
Тип объекта, всегда generation.task
Статус задачи
submitted - Отправлена, ожидает обработки
in_progress - Обрабатывается
completed - Успешно завершено
failed - Ошибка
Используемая модель генерации изображений
Время создания задачи (Unix timestamp)
Время завершения задачи (Unix timestamp, возвращается только при завершении)
URL сгенерированного изображения (возвращается только при успехе)
Оптимизированный промпт (поддерживается некоторыми моделями)
Время истечения URL изображения (Unix timestamp)
Информация об ошибке (только при неудаче)
Справка по статусам задач
Статус Описание Финальный Рекомендуемое действие submittedЗадача отправлена, ожидает обработки ❌ Подождите 2-3 секунды и повторите запрос in_progressЗадача обрабатывается ❌ Подождите 3-5 секунд и повторите запрос completedЗадача успешно завершена ✅ Получите изображение из поля url failedОбработка задачи не удалась ✅ Проверьте информацию об ошибке
Стратегия опроса
Начальное ожидание: 2 секунды
Интервал опроса: 3 секунды
Максимальное ожидание: 120 секунд
Типичное время: 5-30 секунд
Пример опроса на Python
import time
import requests
def poll_image_task ( task_id , api_key , max_wait = 120 ):
"""Опрос задачи генерации изображения до завершения или таймаута"""
start_time = time.time()
interval = 3 # Интервал 3 секунды
while time.time() - start_time < max_wait:
response = requests.get(
f 'https://toapis.com/v1/images/generations/ { task_id } ' ,
headers = { 'Authorization' : f 'Bearer { api_key } ' }
)
data = response.json()
if data[ 'status' ] == 'completed' :
return data[ 'url' ]
elif data[ 'status' ] == 'failed' :
raise Exception ( f "Генерация не удалась: { data[ 'error' ][ 'message' ] } " )
time.sleep(interval)
raise TimeoutError ( "Таймаут задачи" )
Срок действия ресурсов
URL сгенерированных изображений действительны 24 часа
Загрузите и сохраните изображения в течение срока действия
Поле expires_at указывает время истечения изображения (Unix timestamp)
После истечения срока изображения недоступны; для повторного получения отправьте новую задачу
Коды ошибок
HTTP код Тип ошибки Описание 400 invalid_requestНеверные параметры запроса 401 unauthorizedОшибка аутентификации, проверьте API Key 402 insufficient_quotaНедостаточно средств 404 task_not_foundЗадача не найдена 422 content_policy_violationНарушение политики контента 429 rate_limit_exceededПревышен лимит запросов 500 internal_errorВнутренняя ошибка сервера