Files
ttstd-infinite-canvas/backend/internal/protocol/docs/minimax-video.md

2.3 KiB
Raw Blame History

MiniMax 视频生成

MiniMax 视频插件使用 /v2/video_generation 创建异步任务。它同时发送顶层 prompt 和结构化 content[]:文本为 text item,参考图片为带 reference_image role 的 image URL item。

接口与鉴权

{{OPERATIONS}}

POST {channel_base_url}/v2/video_generation
GET  {channel_base_url}/v2/query/video_generation/{task_id}
Authorization: Bearer <MINIMAX_API_KEY>
Content-Type: application/json

模型与约束

当前 MiniMax V2 官方文档列出 MiniMax-H3,时长为 4–15 秒整数,分辨率为 768P 或 2K,比例支持 adaptive、21:9、16:9、4:3、1:1、3:4、9:16。当前 adapter 默认 6 秒;模型名和其他限制仍以账户实际开放能力为准。

参数与字段映射

{{PARAMETERS}}

每张图片构造为 content 中的 image_url item。extra 可覆盖 model、prompt、duration、content、resolution、aspect_ratio。参考视频、参考音频、音频生成和水印当前不发送。

创建任务示例

curl "{channel_base_url}/v2/video_generation" \
  -H "Authorization: Bearer <MINIMAX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"YOUR_MINIMAX_VIDEO_MODEL",
    "prompt":"保持角色一致,人物转身看向镜头",
    "duration":6,
    "content":[
      {"type":"text","text":"保持角色一致,人物转身看向镜头"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.png"},"role":"reference_image"}
    ],
    "resolution":"720P",
    "aspect_ratio":"16:9"
  }'

查询、文件与结果

curl "{channel_base_url}/v2/query/video_generation/task_xxx" \
  -H "Authorization: Bearer <MINIMAX_API_KEY>"

当前 V2 官方成功响应在 task.content.url 返回视频地址,通用 parser 会先合并 task,再从 content.url 提取结果。官方仅允许查询最近 7 天任务,视频 URL 有时效,应立即转存。当前 adapter 尚未发送参考视频、参考音频、callback_url 或 aigc_watermark;虽然 V2 上游支持这些字段,宿主不能宣称已支持。

官方资料

{{CONTRACT}}