建立影片

根據文字提示和選用參考圖片建立非同步任務，並回傳用於查詢狀態和下載結果的 Video ID。

POST/v1/videos

根據文字提示和選用參考圖片建立非同步影片生成任務。API接受 OpenAI Videos 相容的 Multipart 請求，並回傳可用於查詢任務狀態的 Video ID。

不同影片模型支援的長度、尺寸、參考圖片和擴充參數可能不同。請選擇目前的 API Key 可見且支援影片生成的模型 ID。

授權

bearerAuth

授權Bearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

傳遞位置: header

請求主體

multipart/form-data

使用 Multipart 提交提示詞、模型和選用參考圖片。用戶端應由請求庫自動產生 Content-Type 的 boundary。

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

prompt*string

描述期望生成的影片內容。建議明確主體、動作、場景、鏡頭、風格和品質要求。

長度1 <= length

model?string

要使用的影片模型 ID。請選擇目前的 API Key 可見且支援影片生成的模型；不同模型支援的輸入方式和擴充參數可能不同。

長度1 <= length

seconds?string

影片長度，單位為秒，預設值為 4；實際選用長度取決於所選模型。

預設值"4"

size?string

輸出影片尺寸，通常使用 寬度x高度 格式，預設值為 720x1280；實際選用尺寸取決於所選模型。

預設值"720x1280"

input_reference?file

圖片生成影片時上傳的參考圖片。部分相容模型不接受直接上傳檔案，需要改用 metadata.img_url 傳遞圖片 URL。

格式binary

metadata?string

供應商或模型專用擴充參數，必須作為 JSON 字串提交。不要將其中的欄位視為所有影片模型都支援的公共參數。

Wan 系列擴充鍵包括：img_url、first_frame_url、last_frame_url、watermark、prompt_extend、audio、seed 和 resolution。其中圖片 URL 用於圖片生成影片，起始與結束影格 URL 用於關鍵影格影片；audio 僅適用於支援音訊生成的模型。

解析度選項包括 480P（832x480、480x832、624x624）、720P（1280x720、720x1280、960x960、1088x832、832x1088）和 1080P（1920x1080、1080x1920、1440x1440、1632x1248、1248x1632）。實際支援範圍以所選模型為準。

回應主體

`application/json`

curl -X POST "https://example.com/v1/videos" \  -F prompt="一個穿著太空衣的太空人在月球上行走，高品質，電影級" \  -F model="MODEL_ID" \  -F seconds="4" \  -F size="720x1280"

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "status": "processing",
  "progress": 0
}

授權

請求主體

回應主體

201application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`