Skip to main content
POST
Create a MiniMax-H3/H3-Max v2 video task

接口范围

MiniMax 官方 H3/H3-Max v2 能力使用 POST /v2/video_generation 创建任务,并使用 GET /v2/query/video_generation/{task_id} 查询任务。它支持 URL、mm_file 和 data URI 形式的媒体输入。H3 为 768P/2K、4–15 秒;H3-Max 为 480P/768P、5–15 秒。 OneHub 将该能力代理为以下鉴权接口;两者都必须带 Bearer Token:
model 可为 MiniMax-H3 或 MiniMax-H3-Max,均支持文本、首/尾帧和参考素材模式。 minimax-h3-768p-second、 minimax-h3-2k-second 和 minimax-h3-extra-input-image 是 OneHub 内部计费组件 SKU;minimax-h3-max-480p-second 和 minimax-h3-max-768p-second 是 H3-Max 内部 计费组件 SKU。它们不能作为 model 值,也不是可配置的模型 allowlist 条目。

趣猫来源的差异

管理员在 MiniMax 渠道选择“趣猫(第三方 H3)”,地址填写 https://qumao.ai 根地址。 调用方继续使用上表的创建与查询接口、model: "MiniMax-H3";来源标识不代表已核实其底层模型,趣猫不支持 H3-Max。 趣猫仅接受一个最多 4000 字的文本、1–15 秒整数时长、显式 16:9 或 9:16 画幅,以及省略或填写 768P 的分辨率。 可选 seed 必须是有符号 64 位范围内的 JSON 整数,显式零会保留;官方来源不接受此字段。 参考图须用 image_url 加 role: "reference_image",最多九张;参考音频须用 audio_url 加 role: "reference_audio",最多三条,可不配参考图。素材须为公开 HTTPS 地址,不能用 data URI 或 mm_file; 支持的图片格式为 JPG/PNG/WebP,音频为 MP3/WAV/MP4/FLAC。需登录、失效或带签名的素材可能被上游拒绝,查询参数不会被擅自删除。 趣猫不支持首尾帧、参考视频、文件上传、回调、水印控制、重生成或增强提示词操作;这些输入会在创建前拒绝。 创建结果不明时不会自动重发。查询、后台轮询和再次取片保持创建时的渠道与来源,查询故障不等于任务失败; 同一上游编号对应多个本人任务时,使用创建响应的 platform_id 查询。 如果渠道类型、来源或地址已变更,旧任务查询会暂停并返回 409 task_channel_configuration_changed, 后台轮询保留非终态并记录待核对原因,不会携当前新密钥访问旧供应商。恢复匹配配置后可继续查询,同源正常换钥仍使用当前有效密钥;不会重发创建或因此结算。 平台沿用原 H3 的 768P 秒价、超过五张的图片加费及客户价格快照,不另建趣猫价表。 模型发现复用创建入口的来源能力和必需组件价检查,不要求为 MiniMax-H3 补造代表价;当前共享预检要求 minimax-h3-768p-second、minimax-h3-2k-second、minimax-h3-extra-input-image 三项现有有效价格。 管理员在客户价页按用户和分组回读这些组件;绝对客户价可直接生效,折扣价仍需对应平台底价。 公开价格列表会隐藏内部计费组件,不能用其中查不到这些名称来认定尚未配置。 输出秒数取趣猫实际返回值,不向上取整;无输入视频的事实和实际提交图数来自创建时摘要,参考音频不另计费。 task.usage_sources 区分上游返回值、创建请求事实和平台计算值;原始上游响应单独保留。 缺少有效输出秒数、创建摘要或证据矛盾时,任务结果按实际展示,结算标为失败待核对,不作成功零价结算。 沿用官方参考价不代表趣猫实际供应商成本已经核实;再次查询刷新链接不会再次结算,实际经过 24 小时的续取仍需单独验证。 下文保留官方 H3/H3-Max 的原有参数规则,趣猫仅采用本节差异。

官方兼容(第三方 MiniMax)

管理员可在 MiniMax 渠道中选择“官方兼容(第三方 MiniMax)”,填写供应商的 HTTPS 根地址(可含有效端口),不附加 /v1、查询参数或用户信息。切换到此来源通常保留已填地址与模型,不自动填固定供应商域名;从“筷子(H3)”切换时会清空筷子地址,需要重新填写供应商根地址;历史 shuzirensheng 配置仍识别为此选项,原地址保持。 该来源创建响应的 task_id 和 platform_id 均为平台编号 video_<ULID>;查询响应的 task.id 和回调中的 task.id 也使用这个编号。用创建响应的编号查询即可,历史任务已保存的上游编号仍可用于查询。官方 MiniMax 来源继续保持原有任务编号契约。 该来源支持原生 H3/H3 Max 的 /v2/video_generation 和 /v2/query/video_generation/{task_id},以及各模型允许的图片、视频素材;角色互斥、数量、时长和分辨率限制沿用本页模型规则。文本使用 /v1/chat/completions 或 /anthropic/v1/messages,图片使用 /v1/image_generation,平台 OpenAI 图片入口沿用参数转换;实际模型供给和兼容程度由供应商决定。 新视频任务在创建前冻结对应分辨率的输出秒、输入秒和额外图片客户组件价,缺价时不请求上游。H3 输入与输出使用同一每秒客户价,前 5 张图片免费;H3 Max 使用独立输入秒和输出秒价格,前 2 张图片免费。结算使用冻结快照并保证重复执行只扣一次,不将第三方标为官方区域或官方成本。 历史数字人生任务继续使用原快照,按有效输出秒向上取整的旧公式结算。任务绑定创建时来源和地址;改址后暂停查询并返回明确冲突,恢复原配置后可继续,同源同址密钥轮换可以继续使用。所有兼容请求均拒绝跳转第二跳。

筷子(H3)

管理员新建 MiniMax 渠道,在上游供应商中选择“筷子(H3)”,填写筷子 Key。默认模型仍为 MiniMax-H3,普通视频也可配置 MiniMax-H3-Max;保存后重新打开,应保留所选型号。 默认只填写根地址 https://aiopenapi.kuaizi.cn,Kapon 自动补上 /ai-open-platform-api;不要再追加具体创建或查询路径。 已保存的标准长地址 https://aiopenapi.kuaizi.cn/ai-open-platform-api 继续可用,不重复拼接,编辑时回显根地址;原有合法自定义前缀保留。渠道保存后重新打开,应保留独立的筷子来源;已有“官方兼容”渠道不会自动切换成筷子。 H3 与 H3 Max 的普通视频共用原生 content[] 请求结构,Kapon 保留请求中的实际型号,向上游发送: 客户继续使用 Kapon 的 /minimaxi/v2/ 入口及平台任务编号,平台在内部对应上游编号。 HTTPS、同源、禁止跳转和拒绝歧义路径的保护继续生效。普通视频创建和查询允许 MiniMax-H3、MiniMax-H3-Max,不把 Max 改成 H3。 提示词增强仍只允许 MiniMax-H3;本来源不开放视频重生成、文本聊天或图片生成。Max 沿用已有 5–15 秒、480P/768P 和素材校验规则,不支持 4 秒或 2K。具体型号权限和可用档位仍需供应商账号提供,不能由模型配置或接口受理推定生成成功。 其它 MiniMax 来源保持各自的接口路径与请求体;支持普通视频不代表支持提示词增强,自动选择和指定渠道都按操作筛选。 价格使用不带地区后缀的客户计费项。H3 的 768P 视频使用 minimax-h3-768p-second 和 minimax-h3-extra-input-image,输入与输出视频秒数合计使用同一秒价,前五张图片免费。 Max 复用现有 minimax-h3-max-{480p|768p}-second、minimax-h3-max-{480p|768p}-input-second 和 minimax-h3-max-extra-input-image:输出视频和参考视频分别按对应秒价计算,前两张参考图免费,超出部分收费。 H3 与 Max 使用各自下单时冻结的价格;必要价格缺失时不请求上游,用量不完整或型号、规格不一致时不标为正常结算。 提示词增强使用 MiniMax-H3-Context-IR 的输入、输出 token 价;这些计费项不用加入渠道模型列表。 创建前冻结价格,缺价时不请求上游,重复处理不重复收费,也不标为官方地区成本。 筷子文档限制单次提交 4 MB,并忽略 callback_url;Kapon 继续查询任务进度,再沿用现有兼容规则通知客户。 错误返回、日志和重试沿用既有 MiniMax 兼容机制。任务绑定创建时的精确来源和实际请求地址;同一筷子渠道的根地址与标准旧长地址互换,不影响旧任务查询。变更来源、主机或其他非等价路径时旧任务暂停查询,恢复原配置后可继续。

创建请求

本节参数用于普通视频生成。重生成与增强提示词接口的差异见下方专节。
  • duration 必填;H3 为 4–15 秒,H3-Max 为 5–15 秒。
  • resolution 可省略(默认 768P);H3 只能为 768P/2K,H3-Max 只能为 480P/768P。
  • content 必须恰好有一个非空 text 项,提示词最多 7000 个 Unicode 字符; text 项不能设置 role。
  • 媒体项总数最多 12:image_url 最多一个 first_frame、一个 last_frame、9 个 reference_image;video_url 最多 3 个 reference_video;audio_url 最多 3 个 reference_audio。image_url 未提供 role 时会按 first_frame 处理。
  • 首/尾帧模式不能与任何参考素材混用;只有 reference_audio 时,必须同时提供 reference_image 或 reference_video。

比例与模式

  • 文生视频:没有媒体项时,ratio 必填,且必须是具体比例,不能为 adaptive。
  • 首/尾帧:包含 first_frame 或 last_frame 时,OneHub 使用 adaptive。
  • 参考素材:包含任一 reference_* 项时,ratio 可省略(会使用 adaptive), 也可以传 adaptive 或具体比例。
官方来源的 H3-Max 参考模式使用独立的国内/国际价格快照。参考音频免费,前两张输入图片免费; 超额图片按张计费,输入视频按上游实际秒数及输出分辨率单独计费,不能套用输出视频单价。 输出、输入视频、超额图片费用会在日志详情分别展示。管理端可配置 minimax-h3-max-480p-input-second、minimax-h3-max-768p-input-second 和 minimax-h3-max-extra-input-image 及其地区 SKU;这些计费项不能作为请求模型。 新增参考模式缺失价格或地区时会在上游调用前拒绝;结算只使用创建时冻结的客户价和地区快照。 已有文本/首尾帧任务保持原计费版本,不对历史任务补计新增素材费用。 筷子和其他“官方兼容”来源使用前述未带地区的兼容组件价,不要求官方地区;它们按输入、输出视频和额外图片冻结对应的客户价格。 可用比例为 adaptive、21:9、16:9、4:3、1:1、3:4、9:16;前述模式规则会 进一步限制其可用性。

媒体 locator 与大小限制

每个 image_url.url、video_url.url 和 audio_url.url 只能使用下列 locator:
  • 公网 https:// URL。OneHub 会对 URL 做 DNS fail-closed 和私网/回环地址拦截; 不接受 HTTP、file:、ftp:、blob:、javascript: 或协议相对 URL。
  • 严格的 data:<mime>;base64,<payload>。metadata 必须恰为 <mime>;base64,不能有 空白字符,payload 必须是非空严格 Base64。
  • authority-only 的 mm_file://<positive-int64>。只允许正十进制 int64 authority, 不能包含用户信息、端口、路径、query 或 fragment。
对 data URI,OneHub 会验证解码后单文件大小与 MIME: 公网 HTTPS URL 和 mm_file 引用不会由 OneHub 拉取或在本地检查媒体内容,媒体格式等 官方约束由上游校验。完整 JSON 请求体最大为 64 MiB;data URI 的 Base64 膨胀和其他 字段也计入该限制,因此实际可用的解码后大小会低于单文件上限。

创建示例

创建成功只返回 OneHub 的稳定公共标识:

查询任务

将创建响应的 task_id(或 platform_id)放入路径参数:
查询响应保持上游 task 对象,并在顶层附加 platform_id;base_resp 也可能出现。 task 可包含 id、status、model、task_type、resolution、duration、 created_at、updated_at、content.url、usage 和 error。status 与时间字段以 上游实际返回为准。
成功结果中的 task.content.url 是上游签名 URL。它会过期,具体有效期以该 URL 与上游 返回为准;请在收到后及时使用,不要把完整签名 URL 写入日志或长期存储。 对于官方来源,本文档不对创建失败、任务失败或取消时的计费结果作额外承诺;计费与额度以 OneHub 账户 和实际任务结算记录为准。

重生成 2K 视频

POST /minimaxi/v2/video_regeneration 的请求模型仍为 MiniMax-H3。 只能将符合 H3 768P 输出规格的视频重生成 2K;不是任意视频增强服务。 必须显式传 resolution: "2K",不接受 duration 或 ratio。 二选一提供素材:
  • source_task_id:本人在本平台创建、七天内成功完成的 H3 768P 普通生成任务的上游任务 ID。 平台固定使用原渠道;跨用户、过期、失败、不同模型、不同分辨率或指定其他渠道会拒绝。 上游的账号白名单/资格仍须满足;本地归属校验不代表供应商已授权。
  • content:恰好一个 role: "base_video" 的 video_url,以及原生成的非空文本和参考素材。 不可同时传 source_task_id。文本最多 40000 个 Unicode 字符;参考媒体沿用上述数量和安全边界, base_video 不计入参考媒体数量。原视频规格、音频/帧率和素材一致性由上游校验,平台不拉取 URL 检测。
返回 task_id 与 platform_id,通过同一查询接口等待 task_type: "regeneration" 及视频结果。 创建时冻结地区与客户价格。成功后以该次返回的 usage.input_seconds、output_seconds、 total_seconds 和 input_image_count 结算:输入、输出秒数均按重生成单价,超过五张的图片另计, 参考音频免费。base_video 不再作为额外参考视频推算秒数;不会重算原任务的费用。 缺失或矛盾的计量进入待人工核对的失败结算状态;不会用普通生成价或当前价替补。 管理端计费项为 minimax-h3-regeneration-second 和 minimax-h3-regeneration-extra-input-image 及其 #minimax-cn / #minimax-global 地区 SKU。 2026-10-22 核实的官方参考为国内 ¥0.3/秒、¥0.15/超额图,国际 $0.05/秒、$0.025/超额图。 客户实际价格沿用平台地区 SKU、配置汇率和客户价格快照,官方参考不代表合同成本或历史补扣。

Context-IR 增强提示词

POST /minimaxi/v2/h3_context_ir 创建异步文本任务,请求 model 必须是 MiniMax-H3, 不能传内部计费项 MiniMax-H3-Context-IR。content、4–15 秒的 duration 和比例/素材规则与 H3 相同; 不向上游传视频输出分辨率。仍以同一查询接口等待结果,成功结果是 task_type: "h3_context_ir" 下的 content.prompt,不是视频 URL。
创建时冻结独立的 MiniMax-H3-Context-IR 地区客户价格。按上游 usage.prompt_tokens 和 completion_tokens 分别计费,并核对 total_tokens 一致,明确的零用量保留为零; 不使用视频秒费、输入字符估算或提交后的新价格。输入输出费用先合并再向上取整至整数 quota。 2026-10-22 官方参考:国内 ¥5.8/¥23 每百万输入/输出 token,国际 $0.9/$3.6。 价格页显示这两个方向,日志保存原始数量和分项算式。 筷子(H3)来源也支持此接口,使用不带地区后缀的 MiniMax-H3-Context-IR 客户 token 价格, 在请求上游前冻结输入和输出单价。不会要求官方地区价格,也不会记录为官方区域成本; 缺价或价格类型不符时直接拒绝。查询和客户回调返回经任务身份核对的增强结果 content.prompt, 客户可将它用于下一次视频创建。成功回调等待结算完成;用量异常或结算尚未完成时,不发送成功通知。 错误返回、查询故障、日志、重试和通知沿用现有官方兼容规则。 普通“官方兼容”渠道不开放新建提示词增强任务;此操作只选择已明确支持的官方或筷子来源。 重生成仍只支持官方 H3 端点;官方来源的这两个操作均需明确国内/国际地区,完整请求体上限 64 MiB。 供应商可能有更小的请求体限制。官方来源缺地区、任一来源缺价都会在提交前拒绝;任务失败不收费。钱包、令牌、日志和结算状态原子写入, 失败重试及重复终态查询不得重复收费。源码/合成测试不代表账号资格或真实供应商已经验证。 官方参考:重生成、 Context-IR、 国内价目、 国际价目。

Authorizations

Authorization
string
header
required

Authorization: Bearer

Body

application/json
model
enum<string>
required
Available options:
MiniMax-H3,
MiniMax-H3-Max
content
object[]
required

Exactly one text item and at most 12 media items.

Required array length: 1 - 13 elements
duration
integer
required

Output duration in seconds (official H3: 4-15; H3-Max: 5-15; QuMao H3 source: 1-15).

Required range: 1 <= x <= 15
resolution
enum<string>
default:768P

H3 supports 768P/2K; H3-Max supports 480P/768P.

Available options:
480P,
768P,
2K
ratio
enum<string>

Required and concrete for text-only generation; adaptive is used for first/last-frame mode and is the default for reference mode.

Available options:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
callback_url
string
seed
integer<int64>

Optional integer seed for QuMao H3 only; explicit zero is preserved. Official sources reject it.

Response

200 - application/json

Created task identifiers.

task_id
string
required

Upstream task identifier for official channels; video_ for third-party compatible channels.

platform_id
string
required

OneHub platform task identifier.