Chuyển đến nội dung chính
POST
/
video
/
generations
Gửi một task video
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
}

Ủy quyền

​
Authorization
string
header
bắt buộc

Khóa API của OrcaRouter có dạng sk-orca-.... Truyền chúng trong header Authorization: Bearer sk-orca-....

Nội dung

application/json

Chọn biến thể khớp với tiền tố model của bạn:

  • kling/... → Kling video request
  • byteplus/... → Seedance video request
​
model
enum<string>
bắt buộc

Mô hình video Kling (tên hướng tới khách hàng với tiền tố namespace kling/). Endpoint Kling thực sự phục vụ (text2video / image2video / omni-video) được xác định bởi các trường metadata bạn truyền, không phải bởi tên mô hình bạn chọn — nhưng chỉ kling/kling-video-o1 và kling/kling-v3-omni chấp nhận các trường tham chiếu đa nguồn (image_list / video_list).

Tùy chọn có sẵn:
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
Ví dụ:

"kling/kling-v3-omni"

​
prompt
string
bắt buộc

Bắt buộc. Kling từ chối các prompt rỗng / chỉ có khoảng trắng.

​
image
string

Hình ảnh khung đầu tùy chọn cho image-to-video (URL hoặc URI dữ liệu base64). Có thông tin tương quan với metadata.image_tail.

​
metadata
object

Túi tham số dạng tự do được Kling tôn trọng.

Phổ quát (mọi endpoint):

  • mode (string): std (720P) / pro (1080P) / 4k. 4k chỉ trên kling/kling-v3 và kling/kling-v3-omni. Mặc định là std cho text/image-to-video, pro cho Omni-Video.
  • aspect_ratio (string): 16:9 / 9:16 / 1:1.
  • duration (string): Độ dài tính bằng giây, mặc định "5". kling/kling-v3-omni và kling/kling-v3 chấp nhận "3"-"15"; họ v2 và kling/kling-video-o1 chấp nhận "5" hoặc "10".

Chỉ text-to-video và image-to-video (KHÔNG phải Omni-Video):

  • negative_prompt (string): Những thứ cần tránh. Tối đa 2500 ký tự.
  • cfg_scale (number): Khoảng [0, 1], mặc định 0.5. Cao hơn = bám sát prompt nghiêm ngặt hơn. Không hỗ trợ trên các mô hình v2.x.
  • image_tail (string): Hình ảnh khung cuối cho image-to-video khung đầu/khung cuối.

Tham chiếu đa nguồn (endpoint Omni, chỉ kling/kling-video-o1 / kling/kling-v3-omni):

  • image_list (array): [{image_url, type}] — tham chiếu nhiều ảnh. Tham chiếu các ảnh trong prompt bằng <<<image_1>>> v.v.
  • video_list (array): [{video_url, refer_type, keep_original_sound}]. Trên kling/kling-v3-omni bị giới hạn ở 3-10s và chế độ std/pro (không phải 4K).

Tính năng nâng cao (phụ thuộc mô hình — xem Capability Map):

  • multi_shot (bool) + shot_type (customize / intelligence) + multi_prompt ([{index, prompt, duration}]): chế độ đa cảnh. Có trên kling/kling-v3 và kling/kling-v3-omni.
  • sound (string): "on" / "off" — âm thanh bản địa. Có trên kling/kling-v3 và kling/kling-v3-omni (mọi chế độ), và kling/kling-v2-6 (chỉ chế độ pro).
  • watermark_info (object): {enabled: bool}. Phổ quát.

Phản hồi

200 - application/json

Task được chấp nhận (bất đồng bộ — poll /v1/video/generations/{task_id})

Phản hồi submit kiểu OpenAI. Được trả về bởi POST /v1/video/generations (và bí danh đối xứng OpenAI POST /v1/videos).

​
id
string

Task ID. Cùng giá trị với task_id (giữ lại cho client cũ).

​
task_id
string
​
object
enum<string>
Tùy chọn có sẵn:
video
​
model
string

Tên mô hình đúng như khách hàng đã gửi (giữ nguyên bí danh / tiền tố namespace, không phải tên đã được giải về upstream).

​
status
enum<string>

Luôn là queued khi submit thành công.

Tùy chọn có sẵn:
queued
​
progress
integer
Phạm vi bắt buộc: 0 <= x <= 100
​
created_at
integer

Dấu thời gian Unix khi task được gửi.