Skip to main content
GET
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
  • Запрос статуса выполнения и результатов асинхронной задачи генерации изображений
  • Обновление статуса и отслеживание прогресса в реальном времени
  • Получение сгенерированных изображений при завершении задачи
  • Поддержка многоязычности (zh/en/ko/ja)
Все задачи генерации изображений выполняются асинхронно. После отправки задачи необходимо запросить статус и результаты через API запроса. Обычные задачи изображений и видео также доступны через GET /v1/tasks/{task_id} с теми же определениями usage и billing. Эта страница описывает ответ пути запроса генерации, указанного в начале. Примеры показывают поля, а не текущие цены модели или постоянный способ тарификации. Используйте поля и суммы, возвращённые для конкретной задачи.

Авторизация

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

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

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

Ответ

string
Уникальный идентификатор задачи
string
Необязательный бизнес-ID клиента, возвращается только при передаче client_business_id во время создания задачи.
string
Тип объекта, всегда generation.task
string
Статус задачи
  • queued - Отправлена, ожидает обработки
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
integer
Целочисленный процент выполнения от 0 до 100.
string
Используемая модель генерации изображений
integer
Время создания задачи (Unix timestamp)
integer
Время окончания задачи, Unix timestamp. Этот путь запроса возвращает его для успешных и неуспешных задач, если время окончания сохранено.
integer
Время завершения задачи (Unix timestamp, возвращается только при завершении)
integer
Время истечения URL изображения (Unix timestamp)
object
Результат успешной задачи. URL изображения находится в result.data[].url.
object
Необязательные сведения об оплате задачи генерации изображения. Статус оплаты не зависит от статуса генерации: completed не гарантирует завершение расчёта. Если данные оплаты нельзя подтвердить, поле billing целиком отсутствует, а не возвращается как null. Отсутствие поля не означает бесплатную задачу.
object
Необязательные оплачиваемые количества, детализация токенов изображения и счётчики инструментов. Поля charge_type, requests, billed_tokens и другие описаны в разделе Поля использования задачи. Детализация токенов возвращается, только если billing.status равен settled, а сохранённые данные корректны и соответствуют окончательному списанию. Неподтверждённые части опускаются; подтверждённые суммы и изображения остаются доступны.charge_type, requests, billed_tokens и input_images - это оплачиваемые количества, они возвращаются только вместе с billing.status=settled. Задачи с оплатой за запрос, списанной целиком при отправке, также возвращают settled и фактическую сумму. Все счётчики токенов являются неотрицательными целыми числами JSON. Кэшированные токены входят во входные токены и не должны прибавляться повторно. При отсутствии детализации поле output_tokens_details целиком пропускается. usage.tool_usage.web_search может возвращаться отдельно или вместе с токенами изображения.
object
Информация об ошибке (только при неудаче)

Статус оплаты и учёт расходов

Эти правила применяются к запросам статуса задач генерации изображений для любых моделей и каналов. Варианты Sunburst и Flare VIP / Official семейства GPT-Image-2.5 поддерживают статистику токенов; для других моделей её наличие зависит от сохранённых данных расчёта. Суммы в примере показывают формат ответа, а не фиксированную цену.
  • Суммы отражают подтверждённое итоговое списание по задаче. Запрос не выполняет списание, доплату, возврат или пересчёт по текущим ценам моделей. Для учёта используйте возвращённые суммы, а не произведение токенов на текущую цену.
  • Обновляйте сумму по уникальному id задачи, не прибавляя одно и то же списание при каждом опросе. Используйте десятичную арифметику. pending или отсутствие поля означают неизвестный расход, а не ноль.
  • Суммы передаются десятичными строками без фиксированного количества знаков после точки.
  • При отсутствии или несогласованности данных оплаты поле billing может отсутствовать. Если изображение ещё нельзя выдать и задача временно отображается как in_progress, оба поля billing и usage также могут отсутствовать.
  • Успешный Webhook использует для data.usage и data.billing те же условия подтверждения и значения полей, что и этот эндпоинт. Webhook - это снимок на момент создания события; если поле отсутствует, используйте этот эндпоинт как резерв. См. Цены и фактические списания.

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

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

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

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

URL сгенерированных изображений действительны 24 часа
  • Загрузите и сохраните изображения в течение срока действия
  • Поле expires_at указывает время истечения изображения (Unix timestamp)
  • После истечения срока изображения недоступны; для повторного получения отправьте новую задачу

Ошибки и причины сбоя

Ошибки запросов, причины сбоя задач и восстановление описаны в справочнике ошибок. После успешной проверки учитывайте статус задачи; HTTP-статус не является бизнес-кодом ошибки.
Используйте единый Task Webhook, polling оставьте резервом. Интервал не менее 5–10 секунд с jitter; при 429 соблюдайте Retry-After. Batch — максимум 100 задач. См. лимиты.