API 接入：云端出片，本地只收文件，零 GPU 也能用

不想买显卡、又想批量出片？走 API 最省心。计算在云端，本地只收返回的视频文件。

两条接入路径

一是官方/平台 API（如七牛云 MaaS，模型 ID 填 minimax/minimax-h3）：注册拿 Key，在 ComfyUI 模板库搜"MiniMax H3 T2V / FLF2V / R2V"导入工作流，填 Key 运行即可，按秒计费（768P 约 0.5 元/秒，2K 约 0.8 元/秒）。二是本地权重模式：下载开放权重自己跑，一次下载、电费而已。

三种生成模式

文生视频（T2V）最简单；首尾帧生视频（FLF2V）给首帧必填、尾帧可选；参考生视频（R2V）最强也最复杂，可混合 9 张图 + 3 段视频 + 3 段音频，让模型理解它们的关系后生成。

成本提醒

一条成片往往要生成 3 次才选中，把"抽卡成本"计入报价。小批量验证用 API，大批量且要完全控制用本地。

怎么接 API

流程是：在开放平台申请 API key，读官方文档找到对应接口（文本对话、语音合成、生图、生视频各有端点），用官方 SDK 或裸 HTTP 调就行。第一次建议照"快速开始"跑通一个最小调用，确认 key、模型名、参数格式都对上，再往业务里嵌。

接入时把 key 放环境变量或密钥管理，别硬编码进代码仓库——这是新手最容易犯的、也最危险的错误。调通后封装一层自己的函数，后面换模型或升级都好维护。

实战注意

生产环境要处理三件事：一是限流和重试，官方有 QPS 上限，超了要退避重试别硬撞；二是费用监控，长上下文 + 多模态调用烧钱快，加上用量告警；三是错误处理，网络抖断、返回异常要兜底，别让一次失败卡死整个流程。

异步任务（生视频这类耗时操作）要用"提交—轮询—取结果"模式，别同步死等。把这些工程细节提前想好，API 接入才稳，不然 demo 跑得欢、上线就翻车。