跳转到主要内容
GET
/
v1
/
images
/
generations
/
{task_id}
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
}

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 запроса.

Авторизация

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
}

Ответ

id
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
Информация об ошибке (только при неудаче)

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

СтатусОписаниеФинальныйРекомендуемое действие
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 кодТип ошибкиОписание
400invalid_requestНеверные параметры запроса
401unauthorizedОшибка аутентификации, проверьте API Key
402insufficient_quotaНедостаточно средств
404task_not_foundЗадача не найдена
422content_policy_violationНарушение политики контента
429rate_limit_exceededПревышен лимит запросов
500internal_errorВнутренняя ошибка сервера