跳轉到主要內容
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 時間戳。