跳转到主要内容
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
必填

OrcaRouter API 密钥形如 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 拒绝空 / 仅空白字符的 prompt。

​
image
string

可选的图生视频首帧图像（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，Omni-Video 默认 pro。
  • 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"。

仅文生视频和图生视频（不适用于 Omni-Video）：

  • negative_prompt（string）：要避免的元素。最多 2500 字符。
  • cfg_scale（number）：范围 [0, 1]，默认 0.5。 越大越严格遵循 prompt。v2.x 模型不支持。
  • image_tail（string）：尾帧图像，用于首尾帧图生视频。

多源参考（Omni 端点，仅 kling/kling-video-o1 / kling/kling-v3-omni）：

  • image_list（array）：[{image_url, type}] —— 多图参考。 在 prompt 中用 <<<image_1>>> 等引用。
  • video_list（array）： [{video_url, refer_type, keep_original_sound}]。 在 kling/kling-v3-omni 上限制为 3-10s 与 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 时间戳。