接入文档
计费、限制与错误码
API 与网页共用积分余额和线路价格,1 元 = 100 积分,可以在 线路广场 查看各线路的实时报价。
计费规则
- 图片:规格单价 × 张数。
- 视频:按条计费为规格单价;按秒计费为每秒单价 × 时长。
- 视频带参考视频时,乘以该规格的参考视频倍率(四舍五入)。
- 会员折扣最后计算:总价 × 折扣,四舍五入且最少 1 积分;原价为 0 时不扣费。
- 价格以创建任务那一刻为准。想锁定价格可传 expectedCredits,价格变了会拒绝并告诉你最新价格,不会多扣。
扣费与退款
创建任务时预扣积分;任务失败(包括内容未通过上游安全审核)会自动全额退回,无需申请。内容审核由各模型的上游服务执行,不同模型与线路的要求可能不同, 未通过时任务失败原因显示「内容未通过安全审核」,修改提示词或素材后重试即可。
限流与并发
- 每个 Key 每分钟最多 120 次请求(查询也算),超过返回 429。建议每 10–15 秒查询一次状态,或用批量查询。
- 每个账号通过 API 同时排队和生成中的任务最多 10 个,与网页端分开计算,互不占用。
- 平台繁忙时创建请求可能返回 rate_limited,稍后重试即可;已创建的任务不受影响。
参考素材
- 可以传公网 http/https 地址,或上传接口返回的本站地址;不允许内网和保留地址。
- 大小上限:图片 20MB、视频 200MB、音频 50MB;单个文件下载超时 60 秒。
- 类型按文件内容识别:JPG、PNG、WEBP、GIF、MP4、MOV、WEBM、MP3、WAV、M4A。
- 任何一个素材不可用,任务都不会创建,也不会扣费。
结果保留期
通过 API 生成的结果文件保留 30 天,到期自动删除,任务记录仍可查询(outputs 变为空)。请在保留期内下载转存。
错误码
原生接口看响应体的 error,OpenAI 兼容接口看 error.code,取值相同。
| 错误码 | HTTP 状态 | 含义与处理 |
|---|---|---|
| missing_api_key | 401 | 没有带 Authorization 请求头 |
| invalid_api_key | 401 | Key 无效、已停用,或所属账号不可用 |
| openapi_disabled | 503 | 开放 API 暂未开放或维护中 |
| rate_limited | 429 | 请求太频繁,或同时进行的任务已达上限,稍后重试 |
| invalid_params | 400 | 参数缺失或不在可选范围内,data.field 指出是哪个字段 |
| channel_unavailable | 422 | 线路不存在或已下架;不会自动换线路,请改用其他线路 |
| model_not_found | 404 | 线路下没有这个模型(原生接口为 422) |
| price_changed | 409 | 传了 expectedCredits 且与当前价格不一致,data.credits 为最新价格;未扣费 |
| insufficient_credits | 402 | 积分不足,请先充值 |
| invalid_media | 400 | 参考素材地址不可用:格式不对、类型不符、内网地址,或不是本账户的素材 |
| media_too_large | 400 | 参考素材超过大小上限 |
| media_download_failed | 400 | 参考素材下载失败或超时 |
| task_not_found | 404 | 任务不存在或不属于本账户 |
| task_not_completed | 409 | OpenAI 兼容下载接口:任务还没完成或已失败 |
| output_not_found | 404 | OpenAI 兼容下载接口:结果已过保留期 |
| unprocessable | 422 | 请求无法处理,如提示词包含不允许的内容 |
| upstream_error | 502 | 上游服务异常 |
| internal_error | 500 | 服务端异常,请稍后重试 |