视频与文字 · 动作 API 协议
MiniMax-H3 动作说明
Unicomp AI H3动作JSON
使用同一 API Key 获取报价后提交；具体动作以报价结果为准。
报价与提交
POST /v1/h3/tasks，使用本平台本人 API Key。以下是协议示例；没有有效原报价不能提交，未知原单不能重新生成。
H3任务报价
{
"operation": "quote",
"model": "MiniMax-H3",
"action": "generate",
"prompt": "白色背景上的橙色陶瓷杯",
"parameters": {
"resolution": "2K",
"ratio": "16:9",
"duration": 4,
"generate_audio": true,
"watermark": false
}
}先报价，再使用相同Key和输入提交。若closed_reasons不为空，按返回原因调整；有效quoted_amount为正整数。
POST /v1/h3/tasks：先operation=quote，保存input_digest、price_version、quoted_amount；再operation=submit，携Idempotency-Key和对应expected字段。金额单位CNY_MICRO，1元=1000000微元。
H3确认原报价后提交一次
{
"operation": "submit",
"model": "MiniMax-H3",
"action": "generate",
"prompt": "白色背景上的橙色陶瓷杯",
"parameters": {
"resolution": "2K",
"ratio": "16:9",
"duration": 4,
"generate_audio": true,
"watermark": false
},
"expected_input_digest": "<原quote.input_digest>",
"expected_price_version": "<原quote.price_version>",
"expected_quote_amount": "<原quote.quoted_amount正整数>"
}用真实报价值替换占位；expected_quote_amount必须是JSON数字。请求头携同一Idempotency-Key；没有有效报价不可提交。
动作与限制
generate生成视频；regenerate编辑视频；understand返回文字。使用顶层 action，素材使用本人 referenceAssets，原平台任务使用 source_task_id；请使用本人素材 ID。
先报价，再使用相同Key和输入提交。若closed_reasons不为空，按返回原因调整；有效quoted_amount为正整数。
POST /v1/h3/tasks：先operation=quote，保存input_digest、price_version、quoted_amount；再operation=submit，携Idempotency-Key和对应expected字段。金额单位CNY_MICRO，1元=1000000微元。
GET /v1/h3/tasks/<任务UUID>查看原任务；refresh=true刷新已受理任务的状态。查询使用创建任务的同一Key，结果未知时不重复POST。
billing.settlement_pending=true时，向原任务/settle发送POST：{actual_amount:<billing.actual_amount>,price_version:<billing.price_version>,confirmation:已固定字符串settle_original_h3}。补足余额后结算原任务，不重新生成。
generate生成视频，regenerate重新生成视频，understand返回文字；action放在顶层。regenerate仅2K且generate_audio=true；understand的duration为4–15整数。referenceAssets填写本人素材ID、source与角色，不传远程URL。
从已成功视频重新生成时填写source_task_id=<本人原任务UUID>，不传prompt或referenceAssets。视频按输入音视频合计秒数和输出秒数计费，参考图片前5张免费；understand按输入和输出Token计费。先预留报价金额，完成后结算；余额不足时保留原结果等待补足。
视频完成后返回asset_id及私有content下载路径；understand返回text。失败或未知任务的扣费、预留和退款状态以原任务billing为准。
价格与开放条件
当前价格见模型目录。金额使用 CNY_MICRO：1元 = 1,000,000微元。仅同一原 Key 报价的 closed_reasons 为空且 quoted_amount 为已确认正整数时，才可按原摘要、价格版本和金额提交。请使用报价返回的金额与版本，不要自行修改。
原单与结果
同原 Key 使用 GET /v1/h3/tasks/:id 读取原状态；显式 ?refresh=true 只查询已受理的原任务。视频与文字输出按原响应分别读取；未知费用保留原单，不自动重发或退还。原响应给出待结算操作时，才按原金额、版本和 settle_original_h3 确认沿原任务结算。