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 国内官方刊例；国际站按美元官方刊例。

MiniMax H3 Max / Max-Turbo（国内站和国际站）

模型 ID 为 MiniMax-H3-Max、MiniMax-H3-Max-Turbo。两款均支持文生、首帧和首尾帧；Max 额外支持图片、视频、音频多模态参考，Turbo 不支持参考素材。

Max 附加费用：参考视频按 480P ¥0.37 / $0.0553 每秒、768P ¥0.97 / $0.143 每秒计费；参考图片前 2 张免费，从第 3 张起 ¥0.50 / $0.074 每张。音频参考不单独收费。Turbo 仅收输出费用。

Max 总费用 = 输出秒数 × 输出单价 + 输入视频秒数 × 参考视频单价 + max(图片数 − 2, 0) × 图片单价。输入视频以服务返回的 input_seconds 为准，不能把 total_seconds 直接乘输出单价。

参数规则（以下规则专用于 Max / Max-Turbo）：

• duration 为 5–15 的整数秒；resolution 为 480P / 768P。本接口省略时默认 5 秒、768P。
• content 必须有且仅有一项非空 text。媒体使用 { "type": "image_url", "role": "first_frame", "image_url": { "url": "..." } } 的对象格式。
• 最多一张首帧、一张尾帧，尾帧必须配首帧。首尾帧不能与参考素材混用。
• Max 参考上限：9 张图、3 段视频、3 段音频，合计 12 个；仅音频参考不支持。每段视频/音频 2–15 秒；视频总时长、音频总时长分别不超过 15 秒，上游下载后校验。
• 文生使用具体 ratio；首帧/首尾帧建议 adaptive，Max 参考也支持 adaptive。
• 可传 extra: { "prompt_expansion_mode": "disabled" | "balanced" | "quality" }，默认 balanced；可传整数 seed。
• 创建、查询仍使用本页顶部的 XRToken 接口，callback_url 使用 XRToken 的回调机制。

示例：Max 768P 输出 5 秒 + 3 张图 + 10 秒参考视频 + 10 秒参考音频，国内 ¥12.70，国际 $1.904。

参数标准

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.ai/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.ai/v1/videos/generations/$TASK_ID" \
-H "Authorization: Bearer $XRT_API_KEY"

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

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