MiniMax H3 异步任务与示例

环境变量

export SUPERTOKEN_BASE_URL="https://api.supertoken.cc"
export SUPERTOKEN_KEY="YOUR_MODEL_API_TOKEN"
export RESOURCE_API_KEY="YOUR_RESOURCE_API_KEY"
export H3_MODEL="leonardo-minimax-h3-1440p"

创建任务使用 sk-... 模型 API Token；查询任务使用 ak_... 资源 API Key。参考图片和音频 只接受绝对 HTTP/HTTPS URL，本地文件先通过 /v1/media/uploads 上传并取得临时 URL。

H3 固定输出 1440p，请求中不要传 output.resolution。output.aspect_ratio 支持 1:1、3:4、4:3、16:9、21:9、9:16 共 6 种画幅，省略时默认 16:9。

首帧生成

frame 模式中，input.image 是首帧：

{
  "model": "leonardo-minimax-h3-1440p",
  "operation": "generation",
  "input": {
    "prompt": "角色缓慢抬头看向天空，保持服装、面部和背景一致",
    "reference_mode": "frame",
    "image": {
      "url": "https://media.example.com/h3/start.png"
    }
  },
  "output": {
    "duration": 5,
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}

首帧和尾帧

尾帧放在 input.reference_images[0]，不能在没有首帧时单独提交：

{
  "model": "leonardo-minimax-h3-1440p",
  "operation": "generation",
  "input": {
    "prompt": "从清晨平滑过渡到夜晚，保持同一机位和场景结构",
    "reference_mode": "frame",
    "image": {
      "url": "https://media.example.com/h3/morning.png"
    },
    "reference_images": [
      {
        "url": "http://media.example.com/h3/night.png"
      }
    ]
  },
  "output": {
    "duration": 8,
    "aspect_ratio": "21:9",
    "generate_audio": true
  }
}

普通图片参考

images 模式支持一到五张图片。input.image 排在最前，随后按 input.reference_images[] 的顺序传递：

{
  "model": "leonardo-minimax-h3-1440p",
  "operation": "generation",
  "input": {
    "prompt": "保持角色、服装和场景设计一致，生成连续的电影镜头",
    "reference_mode": "images",
    "image": {
      "url": "https://media.example.com/h3/character.png"
    },
    "reference_images": [
      { "url": "https://media.example.com/h3/wardrobe.png" },
      { "url": "https://media.example.com/h3/location.png" },
      { "url": "https://media.example.com/h3/lighting.png" },
      { "url": "https://media.example.com/h3/prop.png" }
    ]
  },
  "output": {
    "duration": 10,
    "aspect_ratio": "9:16",
    "generate_audio": true
  }
}

图片加音频参考

media 模式要求一到五张普通图片和一到三个音频，不支持视频参考。音频支持 MP3/WAV， 调用方不传时长，服务会检测真实文件：

{
  "model": "leonardo-minimax-h3-1440p",
  "operation": "generation",
  "input": {
    "prompt": "保持 @character 的外观，让镜头运动和 @rhythm 的节奏自然同步",
    "reference_mode": "media",
    "image": {
      "url": "https://media.example.com/h3/character.png",
      "name": "character"
    },
    "reference_audios": [
      {
        "url": "https://media.example.com/h3/rhythm.wav",
        "name": "rhythm"
      }
    ]
  },
  "output": {
    "duration": 5,
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}

H3 原生成片音轨不能关闭。省略 output.generate_audio 或传 true 均可；显式传 false 会在扣费和上游提交前返回 400 invalid_video_parameter。

查询任务

curl -sS "$SUPERTOKEN_BASE_URL/v1/video/tasks/$TASK_ID" \
  -H "Authorization: Bearer $RESOURCE_API_KEY" | jq .

任务状态为 succeeded 后，从 result.videos[] 获取地址，并按 url_auth 决定是否携带资源 API Key。不要根据生成耗时推算百分比，以任务返回的 status 和 progress 为准。