建立影片

共用參數位於請求頂層，模型專用參數透過 metadata 傳遞。

POST/v1/video/generations

使用平台 Video Generations 的公共欄位建立海螺影片任務。所有海螺專用參數必須放在 metadata 物件中。

MiniMax-Hailuo-2.3 與 MiniMax-Hailuo-2.3-Fast 支援 6 或 10 秒以及 768P、1080P；MiniMax-Hailuo-02 支援 6 或 10 秒以及 512P、768P、1080P。T2V-01-Director 支援 6 秒和 768P、1080P，T2V-01 支援 6 秒和 720P。I2V-01-Director、I2V-01-live 與 I2V-01 支援 6 秒和 720P、1080P，S2V-01 支援 6 秒和 720P。

實際可用模型及能力以目前的 API Key 回傳的模型清單和所選模型為準。

授權

bearerAuth

授權Bearer <token>

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

傳遞位置: header

請求主體

application/json

海螺影片建立請求。

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

model*string

海螺影片模型 ID。模型記錄包括 MiniMax-Hailuo-2.3、MiniMax-Hailuo-2.3-Fast、MiniMax-Hailuo-02、T2V-01-Director、T2V-01、I2V-01-Director、I2V-01-live、I2V-01 與 S2V-01。

實際可用模型以目前的 API Key 回傳的模型清單為準。

長度1 <= length

prompt*string

描述預期生成的影片內容。

長度1 <= length

size?string

輸出解析度。海螺 2.3 系列支援 768P 和 1080P；MiniMax-Hailuo-02 支援 512P、768P 和 1080P；T2V/I2V/S2V 系列的實際支援範圍取決於模型。

duration?integer

影片長度，單位為秒。海螺 2.3 與 02 系列支援 6 或 10 秒；T2V/I2V/S2V 系列記錄為 6 秒。實際支援範圍以所選模型為準。

metadata?

海螺模型專用擴充參數。

回應主體

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "一隻奔跑的賽博朋克風格的馬，背後是霓虹閃爍的未來城市。",    "size": "768P",    "duration": 6  }'

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

授權

請求主體

回應主體

200application/json

400application/json

401application/json

403

500

`application/json`

`application/json`

`application/json`