概述

01这是什么

H3 Nexus 把视频生成这件事拆成两半：算力来自共享池里的消费级 GPU，可信操作留在平台侧。对调用方而言它就是一套普通的 HTTP API —— 提交任务、轮询状态、下载成片；调度、分派、重试、结算都在下面发生。

模型是 MiniMax H3 开放权重，平台基于开放权重及已配置的模型运行方案提供生成服务。 这带来一组必须遵守的约束（地域排除、署名、举报渠道），都写在模型许可证页。

02一个任务的一生

1. 受理POST /v1/videos 只做鉴权、余额冻结、幂等、落库、入队，绝不等生成，立刻返回 202。
2. 提示词与素材编码H3 编码器生成扩散所需的条件。官方 Context IR 是独立可选项，初始默认关闭，开启后在编码前处理输入。
3. Stage A · 扩散生成派给具备当前任务能力的节点，产出基础视频。实际采样步数与加速方案由任务参数及后台默认配置决定。
4. Stage B · 可选超分2K、4K 任务继续超分；已有 768P 作品也可单独发起 2K 超分。
5. Stage C1 · 转码使用 ffmpeg 将生成帧转为视频，由调度器分配可用的处理节点。
6. Stage C2 · 封装按运行配置执行内容检查、水印与封装。可以由节点完成成片封装并上传，平台负责发布下载地址。
7. 结算双侧账本同时入账 —— 需求侧按成片秒扣费，供给侧按 GPU-秒计收益。

03信任边界

节点是自愿接入的陌生机器，因此准入有七步（许可证接受、地域判定、硬件门槛、 自检基准、观察期等），并带信誉体系与对冲派发。这些对调用方是透明的 —— 对外 API 永不暴露 stage 与节点信息。

04计费口径

• 出片的钱只有 succeeded 才收，实际金额在 usage 字段回显。
• failed 一律不计费（原因都在平台这一侧）。
• cancelled / rejected 只收已经跑完的部分—— 提示词编码、已渲染的片段、你开启的 Context IR。 没跑到的一分不收，明细在 usage.items 里逐项列出。
• 下单即冻结额度，并发提交不会透支；任务终结时结算差额。
• 等待资源时显示 awaiting_capacity；失败时返回具体原因，失败任务不计费。

单价与算例见定价。

05当前限制