Эндпоинты/Media

Получить медиа-задачу

Получить статус и результат асинхронной задачи по её id. Опрашивайте этот эндпоинт, пока status не станет succeeded или failed.

GEThttps://api.sozdai.ai/v1/media/generations/{id}

#Аутентификация

Все запросы передают ключ в заголовке Authorization.

http

Authorization: Bearer sk-corr-...

Параметр	Тип	Обязательный	Описание
`id`	string	Да	id задачи из ответа создания задачи.

bash

curl https://api.sozdai.ai/v1/media/generations/task_abc123 \
  -H "Authorization: Bearer $CORRY_KEY"

Возвращает объект задачи. Основные поля:

Поле	Тип	Описание
`id`	string	Получить медиа-задачу id
`status`	string	Статус задачи: queued / submitted / succeeded / failed / timeout.
`type`	string	Тип медиа: image / video / music.
`model`	string	Запрошенная модель.
`result.urls`	string[]	При успехе. result.urls — массив постоянных URL файлов.
`error`	string	Сообщение об ошибке при сбое.
`cost`	string	Сумма списания за задачу — строка в USD (напр. "0.1200"). См. поле currency.

Примеры ответа

{
  "id": "task_abc123",
  "status": "running",
  "type": "image",
  "model": "gpt-image-2"
}

status	Описание
`queued`	В очереди, ожидает запуска.
`running`	Генерируется у провайдера.
`succeeded`	Готово — result.urls доступен.
`failed`	Сбой — см. error. Холд автоматически возвращён.

При успехе. result.urls — массив постоянных URL файлов.

Код	Значение
`401`	Неверный или отсутствующий ключ
`404`	Запрошенная модель не существует или недоступна

json

{
  "error": {
    "message": "Task not found",
    "type": "not_found"
  }
}