Sora
Sora — семейство моделей для генерации видео через CDNvideo AI Hub media API.
Base URL
https://api.cdnvideo.ru/app/aihub-router/v1/media
Для работы используется обычный ключ AI Hub в заголовке Authorization. Модель для маршрутизации передаётся в X-Model:
Authorization: Bearer ${AIHUB_API_KEY}
X-Model: sora-2
Асинхронная обработка
sora-2 возвращает ID видео, а не готовый файл. После создания задачи опрашивайте GET /videos/{video_id} до статуса completed, затем скачайте видео через GET /videos/{video_id}/content.
Создание video-задачи
POST /videos
Метод создаёт задачу генерации видео по текстовому промпту. Запрос отправляется в формате multipart/form-data, потому что опционально может содержать файл input_reference.
Параметры запроса
| Поле | Тип | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|
prompt |
string |
Да | — | Описание кадра на естественном языке. Для стабильного результата укажите тип плана, субъект, действие, сцену, свет и движение камеры. Лучше делать промпт одноцелевым. |
size |
string |
Нет | 720x1280 |
Размер видео. Возможные значения: 720x1280, 1280x720. |
seconds |
string |
Нет | 4 |
Длительность видео. Возможные значения: 4, 8, 12. |
input_reference |
file |
Нет | — | Одно референс-изображение как визуальный якорь первого кадра. MIME-типы: image/jpeg, image/png, image/webp. Размеры изображения должны точно соответствовать size. |
remix_video_id |
string |
Нет | — | ID ранее завершённого видео для повторного использования структуры, движения и кадрирования. Сейчас не поддерживается. |
Text-to-video
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/videos \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "X-Model: sora-2" \
-F 'prompt=An orange cat sunbathing on a warm windowsill, soft morning light, slow cinematic push-in camera movement' \
-F 'size=1280x720' \
-F 'seconds=12'
Ответ
{
"id": "video_68f892a69ee081908d83e200aa406fec",
"object": "video",
"created_at": 1761120934,
"status": "queued",
"completed_at": null,
"error": null,
"expires_at": null,
"model": "sora-2",
"progress": 0,
"remixed_from_video_id": null,
"seconds": "4",
"size": "1280x720"
}
Video-to-video с референсом первого кадра
Чтобы зафиксировать визуальный стиль и первый кадр, передайте input_reference. Размеры изображения должны точно совпадать со значением size.
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/videos \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "X-Model: sora-2" \
-F 'prompt=A single cinematic shot of the same scene coming alive, gentle camera drift, realistic lighting' \
-F 'size=1280x720' \
-F 'seconds=8' \
-F 'input_reference=@first-frame.png;type=image/png'
Получение статуса задачи
GET /videos/{video_id}
Метод возвращает текущий статус, прогресс и метаданные видео.
Path-параметры
| Параметр | Тип | Обязательное | Описание |
|---|---|---|---|
video_id |
string |
Да | ID видео из поля id, например video_68f892a69ee081908d83e200aa406fec. |
Пример curl
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/videos/video_68f892a69ee081908d83e200aa406fec \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "X-Model: sora-2"
Ответ завершённой задачи
{
"id": "video_68f872d114108190b620f73a4af85c5e",
"object": "video",
"created_at": 1761112785,
"status": "completed",
"completed_at": 1761112941,
"error": null,
"expires_at": 1761199185,
"model": "sora-2",
"progress": 100,
"remixed_from_video_id": null,
"seconds": "12",
"size": "720x1280"
}
Статусы задачи
| Статус | Описание |
|---|---|
queued |
Задача поставлена в очередь. |
in_progress |
Видео генерируется. |
completed |
Видео успешно готово. |
failed |
Задача завершилась ошибкой. Подробности возвращаются в error. |
Скачивание видео
GET /videos/{video_id}/content
Метод возвращает бинарный контент готового видео. Вызывайте его после статуса completed.
Пример curl
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/videos/video_68f872d114108190b620f73a4af85c5e/content \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "X-Model: sora-2" \
--output sora-2-video.mp4
Типовой сценарий
- Создайте задачу через
POST /videos. - Сохраните
idиз ответа. - Опрашивайте
GET /videos/{video_id}до статусаcompleted. - Скачайте готовое видео через
GET /videos/{video_id}/content.
Ограничения
- Для
sora-2указывайтеX-Model: sora-2. sizeпринимает значения720x1280и1280x720.secondsпринимает значения4,8,12.input_referenceпринимает только один файлimage/jpeg,image/pngилиimage/webp.- Размеры
input_referenceдолжны точно соответствовать выбранномуsize. remix_video_idсейчас не поддерживается.