建立影片產生任務

送出影片產生任務，支援文字轉影片與圖片轉影片。回傳任務 ID，可透過 GET 端點查詢任務狀態。

POST /v1/video/generations

服務根位址: https://getrouter.ai

通訊協定: 影片任務 API

驗證: Authorization: Bearer YOUR_API_KEY

請求主體

請求主體為必填。媒體類型: application/json

請求欄位

欄位	型別	必填	說明
`model`	`string`	否	模型/風格 ID
`prompt`	`string`	否	文字描述提示詞
`image`	`string`	否	圖片輸入（URL 或 Base64）
`duration`	`number`	否	影片長度（秒）
`width`	`integer`	否	影片寬度
`height`	`integer`	否	影片高度
`fps`	`integer`	否	影片影格率
`seed`	`integer`	否	隨機種子
`n`	`integer`	否	產生的影片數量
`response_format`	`string`	否	回應格式
`user`	`string`	否	使用者識別碼
`metadata`	`object`	否	擴充參數（例如 negative_prompt、style、quality_level 等）

請求範例

curl --request POST \
  --url https://getrouter.ai/v1/video/generations \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{}'

回應

狀態碼	說明
`200`	已成功建立影片產生任務
`400`	請求參數錯誤

成功回應欄位

欄位	型別	必填	說明
`task_id`	`string`	否	任務 ID
`status`	`string`	否	任務狀態

回應範例

{
  "task_id": "TASK_ID",
  "status": "completed"
}

#建立影片產生任務

#請求主體

#請求欄位

#請求範例

#回應

#成功回應欄位

#回應範例

#相關指南