|
Download docs/API.md from manateelazycat/MiniMax-H3-Duo-AIPod: direct link, hf CLI and curl.
- Browser
- Download file 3.89 kB
-
https://huggingface.co/manateelazycat/MiniMax-H3-Duo-AIPod/resolve/main/docs/API.md
- Command line
-
hf download hf://manateelazycat/MiniMax-H3-Duo-AIPod/docs/API.md
-
curl -L -o API.md https://huggingface.co/manateelazycat/MiniMax-H3-Duo-AIPod/resolve/main/docs/API.md
3.89 kB
| # 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 归属仍使用各自记录。不同模型目录之间的互斥及与既有锁的互操作均有回归检查。 | |