接入文档

计费、限制与错误码

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_key401没有带 Authorization 请求头
invalid_api_key401Key 无效、已停用,或所属账号不可用
openapi_disabled503开放 API 暂未开放或维护中
rate_limited429请求太频繁,或同时进行的任务已达上限,稍后重试
invalid_params400参数缺失或不在可选范围内,data.field 指出是哪个字段
channel_unavailable422线路不存在或已下架;不会自动换线路,请改用其他线路
model_not_found404线路下没有这个模型(原生接口为 422)
price_changed409传了 expectedCredits 且与当前价格不一致,data.credits 为最新价格;未扣费
insufficient_credits402积分不足,请先充值
invalid_media400参考素材地址不可用:格式不对、类型不符、内网地址,或不是本账户的素材
media_too_large400参考素材超过大小上限
media_download_failed400参考素材下载失败或超时
task_not_found404任务不存在或不属于本账户
task_not_completed409OpenAI 兼容下载接口:任务还没完成或已失败
output_not_found404OpenAI 兼容下载接口:结果已过保留期
unprocessable422请求无法处理,如提示词包含不允许的内容
upstream_error502上游服务异常
internal_error500服务端异常,请稍后重试