minimax/minimax-h3 的 API 参考文档,由 Comfy Router 提供服务,模型来自 MiniMax。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段是通过原始 HTTP 发出的同一调用。
模型 ID: minimax/minimax-h3
端点: POST https://api.comfy.org/v2/models/minimax/minimax-h3
- Wait for the result
- Queue and collect later
数据结构
输入
boolean
是否为输出添加 AIGC 水印。默认为 false。
string
可选。用于在质询验证之后接收任务状态变更的 URL。
object[]
必填
驱动生成的内容项。必须包含一个非空 text 项;可选添加 first_frame/last_frame 图像或 reference_* 媒体。
object
音频来源。audio_url 项必填。
string
可公开访问的 URL、mm_file://{file_id} 引用或 data URI。
object
图像来源。image_url 项必填。
string
可公开访问的 URL、mm_file://{file_id} 引用或 data URI。
string
媒体项的角色。可选值:first_frame、last_frame、reference_image、reference_video、reference_audio、base_video。关键帧角色与 reference_* 角色在同一请求中互斥;base_video 标记视频重生成请求的来源视频。
string
提示词文本。每个请求必须且只能包含一个非空 text 项。
string
必填
内容项类型。可选值:text、image_url、video_url、audio_url。
object
视频来源。video_url 项必填。
string
可公开访问的 URL、mm_file://{file_id} 引用或 data URI。
integer
必填
视频时长,单位为秒,5 到 15。
string
模型 ID。可选值:MiniMax-H3。Router 调用方可以省略此字段或发送 null;Router 会在向提供商分发之前注入由请求路径所选择的模型。
string
比例。可选值:adaptive(默认)、21:9、16:9、4:3、1:1、3:4、9:16。文生视频时必填且不能为 adaptive;首帧或尾帧生成时会忽略该字段(按 adaptive 处理)。
string
必填
视频分辨率。可选值:2K、768P。
integer
随机种子,取值范围 [-1, 2^32 - 1];省略或为 -1 时表示随机。格式:
int64GET /v2/models/minimax/minimax-h3/openapi.json 提供的 schema 生成,这与 Router 在请求到达提供商之前用于校验调用的文档是同一份。
输出
object
一个 Minimax V2 视频生成任务。
object
已生成的输出;当 status 为已成功时存在。
string
由成功的 h3_context_ir 任务产生的增强视频提示词。
string
已生成 MP4 的限时 URL。可再次查询以获取刷新后的 URL。
number
已生成视频的时长,单位为秒。
object
status 为失败时的错误详情;包含 code 和 message。
string
任务 ID。
string
该任务使用的模型。
string
已生成视频的实际比例。
string
已生成视频的分辨率。
string
任务状态。可选值:已执行、运行中、已成功、失败、已取消、已过期。
string
任务的类型。
object
为该任务记录的使用量。
integer
integer
number
number
integer
number
integer
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。