MorphogenДокументация
API

Получить видео

GET /v1/videos/{id}: статус задачи генерации.

GET/v1/videos/{id}

Возвращает состояние задачи, созданной через Создать видео. Запрашивайте статус раз в 10 секунд, пока он не станет completed или failed. Задачу видит только организация, которой принадлежит ключ.

Заголовки

ЗаголовокЗначение
AuthorizationBearer <ключ>. Обязателен. Вместо него принимается x-api-key: <ключ>

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

idstringобязательный

Идентификатор задачи из ответа POST /v1/videos, вида video_….

Статусы

СтатусЧто значит
queuedзадача в очереди
in_progressмодель генерирует ролик
completedфайл готов, его можно скачать
failedгенерация не удалась, причина в поле error

Отмена задачи в очереди тоже показывается как failed с кодом cancelled. Задача, которая не закончилась за час, получает failed с кодом timeout. За failed деньги не списываются.

Пример запроса

curl https://api.morphogen.ru/v1/videos/video_7f3a91c2 \
  -H "Authorization: Bearer $MORPHOGEN_API_KEY"

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

{
  "id": "video_7f3a91c2",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "completed",
  "seconds": "4",
  "size": "854x480",
  "created_at": 1760104212,
  "usage": { "cost": "0.2" }
}

У завершённой задачи есть поле usage.cost: стоимость генерации у провайдера в долларах строкой. Цену для вашего баланса показывает история операций в кабинете.

Ошибки

401invalid_api_keyКлюч не найден, отключён или истёк.
404video_not_foundЗадачи нет или она принадлежит другой организации.

Остальные коды: Ошибки.

На этой странице