创建视频

公共参数位于请求顶层，模型专属参数通过 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 返回的模型列表和所选模型为准。

Authorization

bearerAuth

AuthorizationBearer <token>

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

In: header

Request Body

application/json

海螺视频创建请求。

TypeScript Definitions

Use the request body type in TypeScript.

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 返回的模型列表为准。

Length1 <= length

prompt*string

描述期望生成的视频内容。

Length1 <= 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?

海螺模型专用扩展参数。

Response Body

`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
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403

500

`application/json`

`application/json`

`application/json`