Перейти к основному содержанию
GET
Статус задачи
Возвращает текущее состояние задачи. Запрос не ходит к провайдеру — отдаёт сохранённое состояние, поэтому он дешёвый и безопасный для частого опроса. Здесь же лежит результат — в поле resultJson у успешно завершённой задачи.

Объект задачи

failCode — непрозрачный внутренний код. Логируйте его и показывайте пользователю failMsg; не стройте на нём ветвление: набор значений не зафиксирован в контракте.

Состояния

Поле state принимает только три значения:
Фильтр status в GET /api/v1/async/media/tasks принимает длинную форму: pending, processing, completed, failed, cancelled. Это разные пространства имён, и путать их — самая частая ошибка интеграции: фильтр status=completed возвращает задачи, у которых state равен success.
Подробнее — на странице Список задач.

Разбор результата

resultJson — это строка, а не объект. Её нужно распарсить.
Python
Для обычных генераций внутри resultJson лежит ровно {"resultUrls": ["https://…", …]}. Для музыкальных задач объект богаче — там есть tracks с дорожками: Ссылки в resultUrls всегда ведут на наш CDN — адреса провайдера наружу не отдаются.

Ошибка генерации

Если задача завершилась неудачей, failCode и failMsg заполняются, остальные поля остаются как были. Причина может быть в промпте, в параметрах, во входном файле или на стороне провайдера.
Задача чужого аккаунта отвечает 404, а не 403. Не стройте логику на различении этих двух случаев — различить их невозможно, и в этом смысл такого поведения.

Скачать результат

Готовые файлы можно забрать одним запросом: скачивание результата отдаёт сам файл или ZIP-архив, если результатов несколько.

Создать задачу

Запуск генерации

Список задач

Фильтры и пагинация

Жизненный цикл задачи

Скачать, архивировать, удалить

Ошибки

Коды и что с ними делать

Авторизации

Authorization
string
header
обязательно

API-ключ в формате sk-.... Альтернативно — заголовок X-Api-Key: sk-... (совместимо с Anthropic SDK).

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

task_id
string
обязательно

Идентификатор задачи из ответа на создание.

Ответ

Состояние задачи.

code
integer
обязательно
Пример:

200

msg
string
обязательно
Пример:

"success"

data
object