API 参考

计费与余额

从钱包余额扣费、按请求结算。按 token 计费的模型按每 100 万输入/输出 token 计价；图像、视频等任务型模型按次计费。失败请求会自动退款。

#按 token 计价

输入和输出 token 分开计量。每个模型的完整价格会显示在 /models 卡片；每个完成的请求会在请求日志中展示最终实际消费。

usage.json

{
  "usage": {
    "prompt_tokens": 128,
    "completion_tokens": 402,
    "total_tokens": 530
  }
}

请求开始时按最坏情况（max_tokens）预留额度，响应结束后按厂商上报的实际用量核销——最终只为实际用量付费。

图像、视频、TTS 等任务型模型按调用一次固定收费。不同分辨率/时长价格可能不同，请以模型卡片为准。

按次模型可以在一个模型上挂多个档位：图片档位由 size 和 quality 决定，视频档位由时长和分辨率决定。提交时根据请求参数解析档位，每档价格都列在模型卡上。

档位定价

size、quality、时长共同决定计费档位——模型卡列出每档确切价格，失败调用自动退款。

请求失败或异步任务始终未完成时，预扣额度会自动退回。请求日志只展示最终实际消费，因此失败调用不会看起来像一笔独立扣费和退款。

所有用量从一个预付费钱包结算——没有后付费账单。除非密钥单独设了额度上限，所有密钥花的都是同一份余额。

在控制台 → 钱包充值。可用支付渠道（银行卡 / 其他）和最小充值金额以收银台显示为准；兑换码也在同一页使用，即时到账。

余额不过期。若支付成功但几分钟内余额没有变化，请附上支付单号提工单。

余额不够覆盖请求的预留估算时，调用立刻以 402 insufficient_quota 失败——不产生任何扣费。充值后重试即可；已经在跑的长流式不会被中途掐断。

控制台 → 用量按模型、按天、按密钥展示 token 与花费曲线——看哪个项目或模型在烧钱最快的入口。

控制台 → 请求日志是面向用户的 API 消费唯一口径。每一行包含时间、模型、token 用量或按次价格、请求 ID 和最终实际消费金额。

每条请求日志都带有请求标识和时间戳。对某次调用提交工单时，请附上那条记录的时间、模型和请求 ID，客服即可追踪到准确的上游尝试。

不存储 prompt 内容

网关只保存元数据（模型、token、费用、时间、请求 ID），不保存提示词内容；除非你为排查问题主动开启请求记录。

还是没解决？

把请求 ID 或报错信息发给我们，我们来查。