海螺 (Hailuo) 视频生成接口文档 (OpenAI 风格)

本接口通过 new-api 提供 OpenAI 兼容的调用方式，适用于标准视频客户端，参数经过映射。

---

1. 基础调用说明

• 接口地址: POST /v1/video/generations
• 认证方式: Authorization: Bearer $API_KEY

1.1 调用示例 (curl)

curl https://api.agtcloud.ai/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "一只奔跑的赛博朋克风格的马，背后是霓虹闪烁的未来城市，科幻感，极高画质",
    "size": "768P",
    "duration": 6
  }'

1.2 高级扩展参数 (Extra Parameters)

所有非 OpenAI 标准的字段必须放在 metadata 对象中。

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "赛博朋克风格的马",
  "metadata": {
    "prompt_optimizer": true,      // 是否启用提示词优化
    "fast_pretreatment": true,     // 是否启用快速预处理
    "aigc_watermark": false,       // 是否包含 AIGC 水印
    "callback_url": "https://...",  // 回调地址
    "subject_reference": [         // 主体参考 (仅部分模型支持)
      {
        "type": "character",
        "image": ["https://..."]
      }
    ]
  }
}

---

2. 模型列表及限制

模型名称	默认分辨率	支持时长	支持分辨率
MiniMax-Hailuo-2.3	768P	6, 10	768P, 1080P
MiniMax-Hailuo-2.3-Fast	768P	6, 10	768P, 1080P
MiniMax-Hailuo-02	768P	6, 10	512P, 768P, 1080P
T2V-01-Director	768P	6	768P, 1080P
T2V-01	720P	6	720P
I2V-01-Director	720P	6	720P, 1080P
I2V-01-live	720P	6	720P, 1080P
I2V-01	720P	6	720P, 1080P
S2V-01	720P	6	720P

---

3. 任务状态与查询

3.1 任务状态常量

状态文本 (OpenAI)	描述
queued	排队中
processing	处理中
succeeded	成功
failed	失败

3.2 任务查询 (GET)

提交任务后，可以使用任务 ID 进行状态查询。

curl https://api.agtcloud.ai/v1/video/generations/task_id_here \
  -H "Authorization: Bearer $API_KEY"