MiniMax H3 请求参数

接口与其他视频模型相同：

• 国内站创建：POST https://api.xrtoken.net/v1/videos/generations
• 国际站创建：POST https://api.xrtoken.ai/v1/videos/generations
• 查询：GET {同一 host}/v1/videos/generations/{id}

国内站和国际站均提供 MiniMax-H3。计费按生成秒。参考图前 5 张免费，超出另计；请求里带参考视频时，输入视频秒数按同档秒价计。国内站按 MiniMax 国内官方刊例；国际站按美元官方刊例。

参数标准

content 里除文本外，图 / 视频 / 音频必须用下面的 type + role：

规则：

• 媒体 URL 用公网 https。本模型不使用 asset://。
• 图 + 视频 + 音频合计最多 12 个。
• 文生、首尾帧图生、参考生 三选一。first_frame / last_frame 不得与任何 reference_* 同时出现。
• duration 必须是整数，不能是 -1，不能带小数。
• resolution 只接受 768P、2K，大小写按表内写法。
• 文生不要用 adaptive 作为 ratio。

本模型不支持：generate_audio、camera_fixed、watermark、fps、seed、service_tier。

示例

文生视频

curl -sS https://api.xrtoken.net/v1/videos/generations \
-H "Authorization: Bearer $XRT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "model": "MiniMax-H3",
  "content": [
    { "type": "text", "text": "一只橘猫在阳光草地里慢镜头奔跑，电影质感" }
  ],
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9"
}'

图生视频（首帧）

{
  "model": "MiniMax-H3",
  "content": [
    { "type": "text", "text": "苹果在阳光下轻轻滚动" },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/apple.jpg" },
      "role": "first_frame"
    }
  ],
  "duration": 6,
  "resolution": "768P",
  "ratio": "16:9"
}

首尾帧再加一条 "role": "last_frame" 的图片。

参考生视频

{
  "model": "MiniMax-H3",
  "content": [
    { "type": "text", "text": "全程用参考视频的运镜，用参考音频当 BGM" },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/style.jpg" },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": { "url": "https://example.com/cam.mp4" },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": { "url": "https://example.com/bgm.mp3" },
      "role": "reference_audio"
    }
  ],
  "duration": 8,
  "resolution": "2K",
  "ratio": "16:9"
}

查询

创建成功返回任务 id。轮询：

curl -sS "https://api.xrtoken.net/v1/videos/generations/$TASK_ID" \
-H "Authorization: Bearer $XRT_API_KEY"

状态为 queued / processing / succeeded / failed。成功后成片地址在 content.video_url。

完整字段表见 创建视频生成任务。