指南
计费与退款
什么时候扣钱、扣多少、换线路怎么算、失败怎么退。
- 按美元计费:余额按美元计,充值后不过期。
- 用哪条线路就收哪条的钱:提交时按第一条要尝试的线路的价格扣费。
- 换线时调整:一条线路失败、换下一条之前,这笔扣款会改成新线路的价格。新线路更贵就补差价,更便宜就当场退差价。补差价时余额不够,就跳过这条线路,继续试下一条。
- 失败全额退回:任务最终失败(包括超时),这笔扣款全额退回。
- 一个任务一笔账:换线、结算都只修改同一笔扣款,余额记录里每个任务只有一条。
按 token 计价的线路
有些线路的上游按 token 收费(比如 GPT Image 的官方、Azure、Codex 线路),我们也按 token 收:价格是文本输入、图片输入、输出三项,每百万 token 多少美元,见模型页的价格表。
- 提交时按预估扣:按你的参数(画质、分辨率、张数、参考图数量、提示词长度)和模型的 token 估算表算出预估价,先扣这笔。模型页的「价格计算器」用的是同一套算法。
- 完成后按实际结算:任务完成时读取上游返回的实际 token 用量,按线路单价重算,多退少补。任务对象里
quote_usd是提交时的预估,cost_usd是结算后的费用,usage是实际用量。 - 结算的上限:不超过你设的单次最高价(请求里的
max_price_usd或密钥设置),单价按提交时的为准;上游没有返回用量时按预估价收。 - 余额不够补差额时会欠费:差额照扣,余额变为负数,在 余额 页能看到欠款。欠费期间不能提交新任务,已在排队的按 token 计价任务也会失败并退回预扣;充值后先抵扣欠款,余额足够就能继续使用。
- 其余线路按次、按张或按秒计价,提交时的价格就是最终价格。
任务对象里的 cost_usd 是这个任务最终的费用,失败时为 0。在控制台的 余额 页能看到每一笔扣费和退款,点「查看任务」可以看到对应的任务。
密钥消费上限
给密钥设了消费上限时,这个密钥上所有任务的扣费累计不能超过上限,换线时补的差价也算在内。按 token 结算时多出的部分照样计入,可能让已用额度略超上限。到达上限后提交返回 402 key_quota_exceeded;失败退款会把额度还回来。
在线试用
在模型页「在线试用」提交的任务,和 API 调用的计费完全一样。