API
Получить видео
GET /v1/videos/{id}: статус задачи генерации.
GET
/v1/videos/{id}Возвращает состояние задачи, созданной через Создать видео. Запрашивайте статус раз в 10 секунд, пока он не станет completed или failed. Задачу видит только организация, которой принадлежит ключ.
Заголовки
| Заголовок | Значение |
|---|---|
Authorization | Bearer <ключ>. Обязателен. Вместо него принимается 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: стоимость генерации у провайдера в долларах строкой. Цену для вашего баланса показывает история операций в кабинете.
Ошибки
401
invalid_api_keyКлюч не найден, отключён или истёк.404
video_not_foundЗадачи нет или она принадлежит другой организации.Остальные коды: Ошибки.