Получить статус задачи изображения

Запрос статуса выполнения и результатов асинхронной задачи генерации изображений
Обновление статуса и отслеживание прогресса в реальном времени
Получение сгенерированных изображений при завершении задачи
Поддержка многоязычности (zh/en/ko/ja)

Все задачи генерации изображений выполняются асинхронно. После отправки задачи необходимо запросить статус и результаты через API запроса.

Авторизация

Authorization

string

必填

Все эндпоинты требуют аутентификации Bearer TokenПолучить API ключ:Посетите Страницу управления API ключами для получения API ключаДобавьте в заголовок запроса:

Authorization: Bearer YOUR_API_KEY

Параметры пути

task_id

string

必填

ID задачи, возвращенный API генерации изображений

curl --request GET \
  --url 'https://toapis.com/v1/images/generations/task_01KA040M0HP1GJWBJYZMKX1XS1' \
  --header 'Authorization: Bearer <token>'

{
  "id": "img_5b8b19afe5c24ab3a92df996f1a33931",
  "object": "generation.task",
  "model": "gemini-3-pro-image-preview",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1768381010
}

Ответ

string

Уникальный идентификатор задачи

object

string

Тип объекта, всегда generation.task

status

string

Статус задачи

submitted - Отправлена, ожидает обработки
in_progress - Обрабатывается
completed - Успешно завершено
failed - Ошибка

model

string

Используемая модель генерации изображений

created_at

integer

Время создания задачи (Unix timestamp)

completed_at

integer

Время завершения задачи (Unix timestamp, возвращается только при завершении)

url

string

URL сгенерированного изображения (возвращается только при успехе)

revised_prompt

string

Оптимизированный промпт (поддерживается некоторыми моделями)

expires_at

integer

Время истечения URL изображения (Unix timestamp)

error

object

Информация об ошибке (только при неудаче)

显示 Свойства

code

string

Код ошибки

message

string

Описание ошибки

Справка по статусам задач

Статус	Описание	Финальный	Рекомендуемое действие
`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`	Внутренняя ошибка сервера

​Авторизация

​Параметры пути

​Ответ

​Справка по статусам задач

​Стратегия опроса

​Пример опроса на Python

​Срок действия ресурсов

​Коды ошибок

Авторизация

Параметры пути

Ответ

Справка по статусам задач

Стратегия опроса

Пример опроса на Python

Срок действия ресурсов

Коды ошибок