视频生成 · 计费与错误
计费流程
- 提交时预扣：按请求参数估算费用，从余额中预扣。余额不足会直接拒绝，不会创建任务。
- 完成后结算：
- 按次、按秒计费的模型，按实际生成的视频结算；
- 按 token 计费的官转模型，等上游回报实际 token 用量后多退少补；
- 对参考视频按时长收费的模型（如 MiniMax H3），按上游实际计量的参考视频时长结算。
- 失败全额退回：任务状态为
failed时，预扣费用全部退回余额。
最终价格 = 模型单价 × 分组倍率，可在 模型广场 查看；每笔扣费明细见控制台的 使用日志。
常见错误
参数校验失败时直接返回 HTTP 4xx 和英文错误原因，不创建任务、不扣费，按提示修改参数即可。
| 报错内容 | 原因与处理 |
|---|---|
... is not a supported Catcoder video model / 无可用渠道 | 模型名写错，或密钥的分组不是视频分组 |
prompt is required | 缺少 prompt |
duration must be between A and B | 时长超出该模型支持范围，见 模型能力 |
resolution must be one of ... | 该模型不支持这个分辨率 |
... must be a public HTTPS URL ... | 素材链接不是公网 HTTPS 地址，或带了端口、账号密码 |
videos is not supported by this model | 该模型不支持参考视频（音频、图片同理） |
images accepts at most N items | 参考素材数量超过上限 |
end_frame requires first_frame | 只传了尾帧，必须同时传首帧 |
... does not support seed | 该参数仅官转模型支持 |
... does not support automatic duration | duration: -1 仅官转模型支持 |
unsupported field: xxx | 请求体里有本站不认识的字段，请删除 |
| 余额不足 | 前往 钱包 充值 |
任务失败
任务提交成功后，生成过程中仍可能失败（例如内容审核未通过、上游繁忙）。此时查询结果为 failed，error.message 给出原因，费用已自动退回，可以修改提示词或换一条线路重新提交。
部分低价线路成功率较低，重要任务建议优先选择成功率高的线路，可在 渠道状态 查看近期情况。