00-概述
海螺（Hailuo）视频生成 · 概述
文档版本：v1.0.0 | 最后更新：2026-06-05 本平台已完整适配海螺（MiniMax / Hailuo）官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
能力简介
POST /hailuo/v1/video_generation 提交，由 model 与请求体字段区分场景：| 任务类型 | 文档 | 关键入参 |
|---|---|---|
| 文生视频（T2V） | 01-文生视频-T2V | prompt |
| 图生视频（I2V） | 02-图生视频-I2V | first_frame_image |
| 首尾帧生成视频（FL2V） | 03-首尾帧生成视频-FL2V | first_frame_image + last_frame_image |
| 主体参考视频（S2V） | 04-主体参考视频-S2V | subject_reference |
task_id，需通过查询接口轮询任务状态；任务成功后凭 file_id 调用下载接口获取视频文件地址。标准调用流程
创建任务 (POST /hailuo/v1/video_generation)
│ 返回 task_id
▼
查询状态 (GET /hailuo/v1/query/video_generation?task_id=...) ← 轮询直至 Success
│ 返回 file_id
▼
获取下载地址 (GET /hailuo/v1/files/retrieve?file_id=...)
│ 返回 download_url
▼
下载 MP4 视频文件接口地址
| 接口 | 方法 | 地址 |
|---|---|---|
| 创建视频生成任务 | POST | https://platform.shuyanai.com/hailuo/v1/video_generation |
| 查询任务状态 | GET | https://platform.shuyanai.com/hailuo/v1/query/video_generation |
| 获取视频下载地址 | GET | https://platform.shuyanai.com/hailuo/v1/files/retrieve |
路径规则：在平台域名后追加渠道前缀 /hailuo，再拼接海螺官方原始路径即可。
例如官方https://api.minimaxi.com/v1/video_generation→ 平台https://platform.shuyanai.com/hailuo/v1/video_generation。
鉴权
Authorization 头携带 Bearer 密钥进行鉴权：Authorization: Bearer {API_KEY}{API_KEY} 为您在平台控制台创建的接口密钥。请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API_KEY} |
Content-Type | 是 | 固定为 application/json（创建任务接口） |
通用响应状态（base_resp）
base_resp 对象：| 字段 | 类型 | 说明 |
|---|---|---|
status_code | integer | 状态码，0 表示成功，非 0 表示异常 |
status_msg | string | 状态描述信息 |
相关文档
