File size: 3,888 Bytes
d35bec0 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 | # MiniMax H3 Duo API(0.1.0)
公开模型 ID 为 `MiniMax-H3-Duo`。head 监听18588,worker监听18589;业务请求只提交给 head。文本生成带音轨的 MP4,单任务,无排队和流式帧输出。参考图、参考视频、参考音频、LoRA 和 S02 工作流未开放。
`GET /ready` 或 `/health` 返回 `ready: true`、`model: MiniMax-H3-Duo`、`worldSize: 2`;worker另含 `worker: true`。服务在 DiT 权重实际载入后启动 HTTP,文本编码器和 VAE 在首个业务任务中懒加载。健康通过后仍须以真实生成验证整条路径。
`POST /v2/video_generation` 使用 `Authorization: Bearer <部署返回的 API key>`。正文最多65,536字节,仅接受下列字段:
| 字段 | 默认值 | 约束 |
|---|---|---|
| model | MiniMax-H3-Duo | 只能使用这个公开 ID |
| prompt | 必填 | 1~8,000个字符 |
| width | 832 | 320~832,16的整数倍 |
| height | 480 | 192~480,16的整数倍 |
| frames | 56 | 22~56;原生模型向上对齐为22、39或56帧 |
| steps | 20 | 整数1~40 |
| seed | 20260928 | 整数0~2^63−1 |
```json
{"model":"MiniMax-H3-Duo","prompt":"A small red sailboat on a calm lake at sunrise, gentle water and breeze.","width":832,"height":480,"frames":56,"steps":20,"seed":20260928}
```
成功受理返回 HTTP 202 与 `{"task_id":"...","status":"queued"}`。随后以相同 Bearer key 访问 `GET /v2/query/video_generation/{task_id}`,状态为 `queued`、`running`、`succeeded` 或 `failed`。成功响应的 `content` 给出视频下载 URL,含访问令牌;`result` 返回实际宽高、帧数、分阶段耗时、总生成耗时及内容校验。实际帧数以响应为准。公开结果不包含设备文件路径。媒体 URL 和 API key 应按凭据保管。
HTTP 400 表示参数非法,401表示凭据错误,404表示任务或文件不存在,429表示已有任务运行。失败任务返回 `failed`,进程随后退出,由服务重启策略恢复,避免复用可能不同步的双机状态。
客户端可采用 POST 30秒、轮询 GET 20秒的单次超时,冷启动轮询超时后继续查询同一任务,总等待上限建议30分钟。此上限是验收客户端约定,服务端没有另设任务队列截止时间或取消接口。首次 CUDA 驱动代码初始化可能令轮询短暂不可用,原始超时次数与完整 HTTP 等待耗时另行记录。
head 的 `GET /metrics` 无须调用模型或鉴权,首个业务任务前即返回零值 `aipod:requests_total` 和 `aipod:work_total{unit="video_seconds"}`。只累计成功任务,工作量为实际帧数/24;拒绝、失败和健康检查不计入。worker返回404以避免重复计数。运行进程计数在重启时归零,由 AI Pod Agent 持久累计;不报告文本 Token。
当前正式性能及质量工作负载为832×480、56帧、24fps、20步、固定提示词和种子。320×192、22帧、2步另做功能检查。其余范围按原生节点规则开放,未宣称同等速度或逐项完成全部组合的质量基准。
运行时不携带 nvcc、ptxas、Triton 或构建工具。保留 CUDA 驱动对随库 PTX 的即时编译;其实际缓存按硬件、驱动文件、模型快照、运行镜像和完整 profile 的指纹隔离,并以空缓存真实生成验证。
LPK 显式保留参考环境的 `TORCH_ALLOW_TF32_CUBLAS_OVERRIDE=1` 等配置,完整数值环境参与 profile 指纹;不要把去掉这些环境变量的手动启动当作相同的质量或性能配置。
光口事务的日志保存在独立的 `/var/lib/lzc-ai-agent/minimax-h3-duo-network`。修复组件还持有 `/var/lib/lzc-ai-agent/glm53f-network/lock` 的排他锁,与现有 GLM 光口组件协调;共享目录只用于该锁,事务恢复和 Netplan 归属仍使用各自记录。不同模型目录之间的互斥及与既有锁的互操作均有回归检查。
|