建立影片

使用統一的 JSON 結構提交請求並取得任務 ID；模型專用參數透過共用欄位或 metadata 傳遞。

POST/v1/video/generations

根據文字提示和選用圖片建立非同步影片生成任務。API 回傳 task_id，用於後續查詢任務狀態和結果。

不同模型支援的輸入形式和供應商擴充參數可能不同。請選擇目前的 API Key 可見且支援影片生成的模型，並僅傳遞此模型支援的參數。

授權

bearerAuth

授權Bearer <token>

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

傳遞位置: header

請求主體

application/json

使用 JSON 提交模型、提示詞和選用的影片生成參數。

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

model*string

要使用的影片模型 ID。請選擇目前的 API Key 可見且支援影片生成的模型。

長度1 <= length

prompt*string

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

長度1 <= length

duration?number

影片長度，單位為秒。選用範圍取決於所選模型。

fps?integer

輸出影片的影格率。是否支援及選用範圍取決於所選模型。

height?integer

輸出影片高度。可以與 width 配合使用；是否支援取決於所選模型。

width?integer

輸出影片寬度。可以與 height 配合使用；是否支援取決於所選模型。

size?string

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

image?string

圖片生成影片使用的圖片輸入，可以是圖片 URL 或 Base64 資料；實際輸入形式取決於所選模型。

metadata?

供應商或模型專用的擴充參數，例如 negative_prompt、style、quality_level、起始與結束影格和回呼網址。這些欄位不代表所有影片模型均支援。

n?integer

期望生成的影片數量。是否支援及選用範圍取決於所選模型。

response_format?string

期望的回應格式。選用值取決於所選模型和供應管道。

seed?integer

用於控制生成隨機性的種子。是否支援取決於所選模型。

user?string

呼叫端提供的終端使用者識別碼。

回應主體

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一個穿著太空衣的太空人在月球上行走，高品質，電影級",    "size": "1920x1080",    "image": "https://example.com/input.jpg",    "duration": 5,    "metadata": {      "seed": 20231234,      "negative_prompt": "模糊",      "image_tail": "https://example.com/end-frame.png"    }  }'

{
  "id": "video_123",
  "object": "video",
  "model": "MODEL_ID",
  "created_at": 1640995200,
  "task_id": "abcd1234efgh",
  "status": "processing"
}

授權

請求主體

回應主體

201application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`