开始使用
概述
H3 Nexus 视频算力网络 API 在线文档。
01这是什么
H3 Nexus 把视频生成这件事拆成两半：算力来自共享池里的消费级 GPU，可信操作留在平台侧。对调用方而言它就是一套普通的 HTTP API —— 提交任务、轮询状态、下载成片；调度、分派、重试、结算都在下面发生。
模型是 MiniMax H3 开放权重，我们不训练、不修改权重，原样转发。 这带来一组必须遵守的约束（地域排除、署名、举报渠道），都写在模型许可证页。
02一个任务的一生
- 受理
POST /v1/videos只做鉴权、余额冻结、幂等、落库、入队，绝不等生成，立刻返回202。 - Stage A · 扩散生成派给具备能力的共享节点，产出帧序列。命中蒸馏 LoRA 的节点走 8 步加速通道。
- Stage C1 · 转码节点侧用自带的 ffmpeg 把帧压成 h264 中间片。无人认领时平台会跳过这一步， 不会把任务挂死。
- Stage C2 · 封装只在平台侧执行，绝不外派：内容审核、烧入可见水印、封装成可下载的 mp4。
- 结算双侧账本同时入账 —— 需求侧按成片秒扣费，供给侧按 GPU-秒计收益。
03信任边界
一条贯穿全系统的规矩
改变产出的东西，不能由不可信侧决定。采样步数由平台下发而非节点自选；水印在平台侧烧入而非交给节点； 内容审核在平台侧执行。把水印交给不可信节点等于没打。节点是自愿接入的陌生机器，因此准入有七步（许可证接受、地域判定、硬件门槛、 自检基准、观察期等），并带信誉体系与对冲派发。这些对调用方是透明的 —— 对外 API 永不暴露 stage 与节点信息。
04计费口径
- 出片的钱只有
succeeded才收，实际金额在usage字段回显。 failed一律不计费（原因都在平台这一侧）。cancelled/rejected只收已经跑完的部分—— 提示词编码、已渲染的片段、你开启的 Context IR。 没跑到的一分不收，明细在usage.items里逐项列出。- 下单即冻结额度，并发提交不会透支；任务终结时结算差额。
- 排队 30 分钟无人认领 → 任务失败且全额不计费。
单价与算例见定价。
05当前限制
内测期，如实说明
- 内容审核是占位规则（关键词匹配，输出侧一律放行），真实供应商尚未接入。
- 只有可见水印，没有隐式数字水印。见生成内容标识。
- 2K 档（Stage B）未实现，节点侧明确报错而不是静默交假活。
- 单价是有推导链的经验值，尚未在 24GB 级显卡上实测校准。