API 文档

计费与频率限制

什么时候扣算力、什么时候退。

计费口径

通过接口调用与在网页里操作是同一套账:扣同一个账号的算力,走同一份价目表,流水一并记在「钱包 → 收支明细」里,来源可区分。

  • 生图:所选规格档单价 × 张数。未配规格或规格价格为 0 时不可调用。
  • 生视频:per_sec 模型按档价 × 时长,per_unit 模型按档价一次计费。具体看 /v1/models 的 billing 与 specs。
  • 文本对话:按 token 算,输入与输出各有单价,向上取整、每次至少 1 点。
  • 生图/生视频在提交那一刻就扣费,不是出图完成时;文本调用前先预扣 1 点,生成完再按实际 token 补扣差额,明确失败会退回预扣。

什么情况会退还

  • 提交给渲染方失败:立即原路退还。
  • 渲染过程中失败:任务转 failed 时自动退还。
  • 任务长时间无人推进:后台兜底会收尾并退还。
  • 生成结果不满意:不退。这与在网页里操作一致,出图本身消耗的是真实成本。

频率限制

每把密钥每分钟最多 120 次调用,超出返回 429 rate_limit_exceeded。这个阈值是用来拦住失控脚本的,正常业务量不会碰到;轮询请按建议间隔来,不要写成毫秒级死循环。

此外还有账号维度的并发与每日生成额度,由你所在的套餐决定,触发时返回 429 concurrency_limit_reached。

遇到 429 请退避重试(例如等待时间逐次翻倍),立刻重试只会继续撞墙。