Перейти к основному содержанию
POST
/
video
/
generations
Отправить задачу видео
curl --request POST \
  --url https://api.orcarouter.ai/v1/video/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling/kling-v3-omni",
  "prompt": "<string>",
  "image": "<string>",
  "metadata": {}
}
'
{
  "id": "<string>",
  "task_id": "<string>",
  "model": "<string>",
  "progress": 50,
  "created_at": 123
}

Авторизации

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

API-ключи OrcaRouter выглядят как sk-orca-.... Передавайте их в заголовке Authorization: Bearer sk-orca-....

Тело

application/json

Выберите вариант, соответствующий префиксу вашей model:

  • kling/... → Kling video request
  • byteplus/... → Seedance video request
​
model
enum<string>
обязательно

Видеомодель Kling (клиентское имя с префиксом пространства имён kling/). Эндпоинт, который Kling фактически обслуживает (text2video / image2video / omni-video), определяется полями metadata, которые вы передаёте, а не выбранным именем модели — но только kling/kling-video-o1 и kling/kling-v3-omni принимают поля мультиисточниковой ссылки (image_list / video_list).

Доступные опции:
kling/kling-v2-master,
kling/kling-v2-1-master,
kling/kling-v2-5-turbo,
kling/kling-v2-6,
kling/kling-v3,
kling/kling-video-o1,
kling/kling-v3-omni
Пример:

"kling/kling-v3-omni"

​
prompt
string
обязательно

Обязательно. Kling отклоняет пустые промпты или промпты только из пробелов.

​
image
string

Опциональное изображение первого кадра для image-to-video (URL или base64 data URI). Взаимно информативно с metadata.image_tail.

​
metadata
object

Свободный набор параметров, поддерживаемый Kling.

Универсальные (все эндпоинты):

  • mode (string): std (720P) / pro (1080P) / 4k. 4k только на kling/kling-v3 и kling/kling-v3-omni. По умолчанию std для text/image-to-video, pro для Omni-Video.
  • aspect_ratio (string): 16:9 / 9:16 / 1:1.
  • duration (string): Длина в секундах, по умолчанию "5". kling/kling-v3-omni и kling/kling-v3 принимают "3"-"15"; семейство v2 и kling/kling-video-o1 принимают "5" или "10".

Только для text-to-video и image-to-video (НЕ Omni-Video):

  • negative_prompt (string): Чего избегать. Максимум 2500 символов.
  • cfg_scale (number): Диапазон [0, 1], по умолчанию 0.5. Выше = строже следование промпту. Не поддерживается на моделях v2.x.
  • image_tail (string): Изображение последнего кадра для image-to-video по первому/последнему кадру.

Мультиисточниковая ссылка (эндпоинт Omni, только kling/kling-video-o1 / kling/kling-v3-omni):

  • image_list (array): [{image_url, type}] — мультиизображения. Ссылайтесь на изображения в промпте как <<<image_1>>> и т.д.
  • video_list (array): [{video_url, refer_type, keep_original_sound}]. На kling/kling-v3-omni ограничено 3-10с и режимом std/pro (не 4K).

Расширенные возможности (зависят от модели — см. Capability Map):

  • multi_shot (bool) + shot_type (customize / intelligence) + multi_prompt ([{index, prompt, duration}]): режим мультикадра. Доступно на kling/kling-v3 и kling/kling-v3-omni.
  • sound (string): "on" / "off" — нативное аудио. Доступно на kling/kling-v3 и kling/kling-v3-omni (любой режим), а также kling/kling-v2-6 (только режим pro).
  • watermark_info (object): {enabled: bool}. Универсально.

Ответ

200 - application/json

Задача принята (асинхронно — опрашивайте /v1/video/generations/{task_id})

Ответ на отправку в стиле OpenAI. Возвращается POST /v1/video/generations (и OpenAI-симметричным алиасом POST /v1/videos).

​
id
string

ID задачи. То же значение, что и task_id (сохранено для устаревших клиентов).

​
task_id
string
​
object
enum<string>
Доступные опции:
video
​
model
string

Имя модели в том виде, в каком его прислал клиент (алиас / префикс пространства имён сохраняются, а не имя, разрешённое провайдером).

​
status
enum<string>

Всегда queued при успешной отправке.

Доступные опции:
queued
​
progress
integer
Требуемый диапазон: 0 <= x <= 100
​
created_at
integer

Unix-метка времени отправки задачи.