Перейти к содержанию

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

Типовой сценарий

  1. Создайте задачу через POST /videos.
  2. Сохраните id из ответа.
  3. Опрашивайте GET /videos/{video_id} до статуса completed.
  4. Скачайте готовое видео через 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 сейчас не поддерживается.