MiniMax 视频入站协议

方法	路径	用途
`POST`	`/minimax/v2/video_generation`	创建视频生成任务
`GET`	`/minimax/v2/video_generation/{task_id}`	查询任务状态与结果
`DELETE`	`/minimax/v2/video_generation/{task_id}`	取消未完成的任务并退回预扣

这是 MiniMax 视频生成 V2 的原厂入站协议，主要面向 MiniMax-H3 系列视频模型。和 Ark 通道一样，它跑在平台托管的异步任务流水线上——请求体是 MiniMax 自己的形状，响应体也按 MiniMax 的形状渲染，所以照着 MiniMax 官方文档写的客户端可以直接解析。

任务落在平台侧，维度计费、产物持久化、预扣/结算都照常生效。

创建任务

bash

curl https://api.modelgo.com/minimax/v2/video_generation \
  -H "Authorization: Bearer $MODELGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<model>",
    "content": [
      { "type": "text", "text": "一个男孩在海边打篮球" },
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "role": "first_frame" }
    ],
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9"
  }'

创建响应就是 MiniMax 文档里的裸任务句柄：

json

{ "task_id": "424010985738629" }

请求体字段

content[] 是多模态数组，每项由 type 与 role 共同决定它的用途：

`type`	可用 `role`	含义
`text`	——	提示词
`image_url`	`first_frame` / `last_frame`	首帧 / 尾帧图
`image_url`	`reference_image`	参考图
`video_url`	`reference_video`	参考视频
`audio_url`	`reference_audio`	参考音频

首尾帧与参考素材不能混用：带了 first_frame / last_frame 就不能再带任何 reference_*，

反之亦然——它们对应上游两种不同的生成任务。

resolution、duration、ratio 与 content 平级。对 MiniMax-H3，取值范围为

resolution ∈ 768P / 2K，duration 为 4–15 的整数，ratio ∈ 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16；不传时按上游缺省（2K、5 秒）执行并按该缺省档计费。

提示词长度上限约 7000 字符。
具体支持哪些取值仍以 model 对应的逻辑模型配置为准。

查询任务

bash

curl https://api.modelgo.com/minimax/v2/video_generation/424010985738629 \
  -H "Authorization: Bearer $MODELGO_API_KEY"

查询响应是 task 信封，与创建响应形状不同：

json

{
  "task": {
    "id": "424010985738629",
    "model": "<model>",
    "status": "succeeded",
    "created_at": 1756600000,
    "updated_at": 1756600120,
    "content": { "url": "https://.../video.mp4" },
    "resolution": "2K",
    "duration": 5,
    "ratio": "16:9",
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 1
    },
    "task_type": "generation",
    "modality": "video"
  }
}

status 取值为 queued / running / succeeded / failed。
成功后产物地址在 task.content.url。
usage 以秒计量（H3 按输出秒数定价），不是 token 数；上游只报告 token 而没有秒数时该字段缺省。
失败时追加 task.error（code / message）。这一项不在 MiniMax 官方成功响应结构里，

是为了让失败原因可见而额外补上的，按官方结构解析的客户端会自然忽略它。

取消任务

bash

curl -X DELETE https://api.modelgo.com/minimax/v2/video_generation/424010985738629 \
  -H "Authorization: Bearer $MODELGO_API_KEY"

取消后预扣退回。注意本通道不会返回 MiniMax 文档中的 cancelled 状态——已取消的任务统一以 failed 呈现，以保证预扣被退回而不是结算。

关键约定

id / task_id 都是网关任务 ID，不是上游任务 ID；查询与取消只认它。
该通道不锁定上游 family，由 model 对应逻辑模型的路由决定实际承接方，路径拼写不参与选路。
产物内容接口只有 OpenAI 兼容那一条（GET /v1/videos/{task_id}/content），MiniMax 路径下没有对应端点。

标准化入口见OpenAI 兼容视频流。