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

Авторизация

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

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

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

Ответ

string
Уникальный идентификатор задачи
string
Тип объекта, всегда generation.task
string
Статус задачи
  • submitted - Отправлена, ожидает обработки
  • in_progress - Обрабатывается
  • completed - Успешно завершено
  • failed - Ошибка
string
Используемая модель генерации изображений
integer
Время создания задачи (Unix timestamp)
integer
Время завершения задачи (Unix timestamp, возвращается только при завершении)
string
URL сгенерированного изображения (возвращается только при успехе)
string
Оптимизированный промпт (поддерживается некоторыми моделями)
integer
Время истечения URL изображения (Unix timestamp)
object
Необязательные сведения об оплате задачи генерации изображения. Статус оплаты не зависит от статуса генерации: completed не гарантирует завершение расчёта. Если данные оплаты нельзя подтвердить, поле billing целиком отсутствует, а не возвращается как null. Отсутствие поля не означает бесплатную задачу.
object
Необязательная статистика токенов изображения после расчёта. Поля токенов возвращаются только при billing.status=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. Если одно из полей отсутствует, используйте этот эндпоинт как резерв. См. Цены и фактические списания.

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

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

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

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

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

Коды ошибок

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