计费与错误
七、计费说明
- 提交时预扣费用，任务完成后按实际结算
- 任务失败不收费，预扣费用自动退回，以账户账单的回退结果为准
- 部分模型按「次」计费，不随时长变化
- 具体计费方式与价格以控制台模型广场为准
八、错误返回
{
"error": {
"message": "错误说明",
"type": "new_api_error",
"code": "错误码"
}
}type 固定为 new_api_error；code 可能为空字符串，请勿用 code 做「是否为空」以外的判断，一律以 message 为准。
实际 code 取值示例
code | 出现场景 |
|---|---|
model_not_found | 模型名不存在，或当前令牌分组下无可用渠道 |
fail_to_fetch_task | 任务提交阶段生成服务返回错误 |
upstream_create_failed | 请求体过大等受理失败 |
xdeal_reference_media_missing | 参考素材缺失或 @ 引用不匹配 |
invalid_request_error | 请求路径或方法不合法 |
HTTP 状态码
| HTTP | 含义 | 处理方式 |
|---|---|---|
| 400 | 参数不合法（如 seconds 类型错误、分辨率不支持） | 按 error.message 修正 |
| 401 | 令牌无效或过期 | 检查令牌 |
| 403 | 三种情况：① 余额/额度不足 ② 令牌权限不足 ③ 任务提交超时（视频生成失败，提交任务超时，请稍后重试） | 读 message 区分：额度问题需充值；提交超时请稍后重试 |
| 404 | 模型或任务不存在 | 核对模型名 / task_id |
| 413 | 请求体过大 | 素材改用 URL，勿内嵌 Base64 |
| 422 | 素材缺失或引用不匹配 | 检查素材 URL 与提示词中的 @ 引用（如 @图1） |
| 429 | 请求频率超限 | 降低频率后重试 |
| 503 | 无可用渠道 | 检查模型名拼写、令牌分组是否有该模型权限 |
| 5xx | 服务异常 | 保留 task_id 联系我们，勿盲目重试 |
503 报错示例
{"error":{"code":"model_not_found",
"message":"No available channel for model xxx under group default (distributor)"}}见到该报错，先核对 model 拼写，再确认你的令牌所属分组是否已开通该模型。若确认无误仍报此错，请联系我们开通。
注意：任务提交成功后的生成失败不通过 HTTP 状态码返回，而是体现为查询结果的 status = FAILURE。请区分「接口调用失败」与「任务生成失败」两类情况。
重试建议：网络异常时先查询原任务，不要直接重复创建。创建任务后请保存 task_id，作为后续排查的唯一依据。