MiniMax H3 参数与错误

公共字段

字段	必填	说明
model	是	固定使用 leonardo-minimax-h3-1440p
operation	是	固定为 generation
input.prompt	是	去除首尾空格后不能为空，最多 1200 个 Unicode 字符
input.reference_mode	有参考素材时是	frame、images 或 media；纯文本可省略
input.image	否	第一张图片；frame 中是首帧
input.reference_images	否	后续有序图片；frame 中第一项是尾帧
input.reference_audios	否	仅 media；1–3 个 HTTP/HTTPS 音频 URL，不传时长
output.duration	是	5–15 秒整数
output.resolution	禁止传	模型固定输出 1440p，传入该字段会返回 400 invalid_video_parameter
output.aspect_ratio	否	支持 6 种：1:1、3:4、4:3、16:9、21:9、9:16；默认 16:9
output.generate_audio	否	H3 原生成片音轨固定开启；省略或传 true，不能传 false

请求中不要传 input.reference_videos、input.video 或 provider_options。

分辨率与画幅

H3 只提供一个固定的 1440p 模型规格，不支持通过请求参数切换分辨率。output.aspect_ratio 共支持以下 6 种值：

画幅	输出尺寸
1:1	1440 × 1440
3:4	1440 × 1920
4:3	1920 × 1440
16:9	2560 × 1440
21:9	3360 × 1440
9:16	1440 × 2560

参考模式

模式	图片数量	音频数量	语义
省略	0	0	纯文本生成
frame	1–2	0	第一张是首帧，第二张是尾帧
images	1–5	0	全部为普通图片参考，不具有首尾帧语义
media	1–5	1–3	普通图片加音频参考，不支持视频

frame、images 和 media 不能在同一任务混用。图片来源保持 input.image 在前、 input.reference_images[] 在后的顺序。音频支持 MP3/WAV，单个最多 15 MB、实际时长至少 2 秒，全部参考音频总时长最多 15 秒；调用方不提供时长字段。

计费

计费由模型价格、output.duration 和用户分组倍率决定。参考图片/音频数量不改变计费秒数； 调用方不需要换算服务端资源消耗。

常见错误

错误码	原因	处理方式
invalid_video_duration	时长不是 5–15 秒	调整 output.duration
invalid_video_aspect_ratio	画幅不受支持	使用表中的六种画幅
unsupported_reference_mode	有参考素材但缺少模式，或模式不受支持	按素材组合使用 frame、images 或 media
reference_image_limit_exceeded	frame 超过 2 张或 images 超过 5 张	删除多余图片
unsupported_reference_video	传入视频参考	移除 input.reference_videos
unsupported_reference_audio	在 frame 或 images 中传入音频	改用图片加音频的 media，或移除音频
reference_audio_limit_exceeded	音频超过 3 个	删除多余音频
invalid_video_parameter	media 缺图片/音频，或显式关闭 H3 成片音轨	补全图片和音频，且不要传 output.generate_audio=false
private_generation_unavailable	当前服务资源不支持 H3 私有生成	联系服务管理员检查该模型的可用资源
idempotency_key_conflict	同一 Key 用于不同请求	新请求使用新的 Idempotency-Key

参数类 400 不应自动重试。任务进入 submission_unknown 时不要重新创建任务，应先由管理员确认上游是否已接受原请求。