メインコンテンツへスキップ
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) は選んだモデル名 ではなく渡すメタデータフィールドで決定される ——しかし 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

画像-to-動画 (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 のみ。 テキスト/画像-to-動画は既定 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" を 受け付ける。

テキスト-to-動画と画像-to-動画のみ (Omni-Video には NOT):

  • negative_prompt (string): 避けるもの。最大 2500 文字。
  • cfg_scale (number): 範囲 [0, 1]、既定 0.5。高いほど プロンプトへの厳密な追従。v2.x モデルではサポート なし。
  • image_tail (string): 最初/最後のフレーム画像-to-動画 のための最後のフレーム画像。

マルチソース参照 (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-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 タイムスタンプ。