建立影片

OpenAI Sora 相容格式的影片生成介面。支援文生影片與圖/影片參考生成模式。

• POST /v1/videos：建立影片任務
• GET /v1/videos/{video_id}：查詢任務狀態
• GET /v1/videos/{video_id}/content：取得影片二進位內容

目前不對外提供：

• GET /v1/videos
• POST /v1/videos/{video_id}/remix

標準鑑權標頭：

• Content-Type: application/json

1. POST /v1/videos 建立任務，取得 id
2. 輪詢 GET /v1/videos/{id}，直到 completed 或 failed
3. 完成後優先使用回傳中的 video_url
4. 如需統一下載，呼叫 GET /v1/videos/{id}/content

核心參數：

• model: string：必填，對外模型名稱
• prompt: string：建議，影片生成描述
• seconds: number|string：可選，目標時長
• duration: number|string：可選，時長別名
• size: string：可選，輸出尺寸
• mode: string：可選，常見值 t2v i2v i2v_first_last reference_material

常用相容參數：

• aspect_ratio
• ratio
• quality
• resolution
• fps
• image
• image_url
• image_urls
• images
• reference_images
• input_reference
• end_image_url
• last_image_url
• video_urls
• audio_urls
• function_mode
• content
• callback_url
• external_task_id

Kling 常用擴充參數：

• model_name
• negative_prompt
• cfg_scale
• sound
• camera_control
• image_list
• video_id
• task_id
• watermark_info

4.1 Veo 系列

說明：stable、official 等表示不同分組，並非對外的 model 後綴；呼叫時請保持 model 為基礎模型名稱，由帳戶或權杖分組決定實際使用哪個分組。

Veo 3.x 主模型

• veo3
• veo3-fast
• veo3-fast-frames
• veo3-frames
• veo3-pro
• veo3-pro-frames
• veo3.1
• veo3.1-fast
• veo3.1-pro
• veo3.1-components
• veo3.1-4k
• veo3.1-pro-4k

建議：

• 純文字生成影片優先使用 veo3* / veo3.1* 主模型
• 圖生影片或參考生成影片的場景，建議明確傳入 mode + image_url/reference_images

4.2 Sora 系列

基礎模型：

• sora-2
• sora-2-pro

建議：

• sora-2* 適合通用調用
• 如需使用 stable / official 等分組，請保持 model 為基礎模型名稱，不要在模型名稱後追加後綴。

4.3 Seedance 系列

對外模型：

• doubao-seedance-1-0-lite-t2v-250428
• doubao-seedance-1-0-lite-i2v-250428
• doubao-seedance-1-0-pro-250528
• doubao-seedance-1-0-pro-fast-251015
• doubao-seedance-1-5-pro-251215
• doubao-seedance-2-0-260128
• doubao-seedance-2-0-fast-260128

建議：

• 文生影片優先 *-t2v-* 或 pro / fast
• 圖生影片優先 *-i2v-*
• 複雜參考素材場景優先使用 content

4.4 Grok 影片系列

對外模型：

• grok-imagine-1.0-video
• grok-imagine-video-1.5-preview
• grok-video-3

常用參數：

• prompt
• ratio / aspect_ratio
• resolution / size
• seconds / duration
• image / image_url / input_reference
• reference_images

範例：

{
"model": "grok-imagine-1.0-video",
"prompt": "雨夜霓虹街道上的电影感推镜，光影丰富，运动自然",
"reference_images": [
"https://example.com/ref-1.jpg"
],
"seconds": 10,
"aspect_ratio": "16:9",
"resolution": "720P"
}

4.5 Kling 影片主模型

對外主模型：

• kling-video

必填：

• model
• model_name

支援的 model_name：

• kling-v1
• kling-v1-5
• kling-v1-6
• kling-v2-master
• kling-v2-1
• kling-v2-1-master
• kling-v2-5-turbo
• kling-v2-6
• kling-v3

常見 mode：

• t2v
• i2v
• multi_i2v
• extend

最小輸入參數：

• 文生影片：model + model_name + prompt + mode=t2v
• 圖生影片：model + model_name + prompt + mode=i2v + image
• 多圖參考：model + model_name + prompt + mode=multi_i2v + image_list
• 影片延長：model + model_name + mode=extend + video_id

範例：

{
"model": "kling-video",
"model_name": "kling-v2-6",
"mode": "t2v",
"prompt": "海边日落镜头，电影感，风吹长发",
"duration": 5,
"aspect_ratio": "16:9"
}

• mode=t2v

• 最小輸入參數：model + prompt

• mode=i2v

• 最小輸入參數：model + prompt + image_url

• mode=i2v_first_last

• 最小輸入參數：model + prompt + image_url + end_image_url

• mode=reference_images

• 最小輸入參數：model + prompt + reference_images

• mode=reference_material

• 最小輸入參數：model + prompt + (image_urls/video_urls/audio_urls 至少一种)

Gemini Omni 呼叫說明

• gemini-omni 是 new-api 對外公開的影片模型名稱，可直接走 POST /v1/videos。
• mode=t2v：文生影片，最小入參為 model + prompt。
• mode=r2v：參考圖/參考素材生成，圖片可放在 image、image_url、images、image_urls、reference_images、input_reference 或 content 中。
• mode=edit：影片編輯，影片可放在 video、video_url、videos 或 content 中，也可同時傳參考圖。
• 時長欄位可用 seconds 或 duration，會自動匹配到 4 / 6 / 8 / 10 秒檔。