计费与结算
官方原价、币种与汇率、预留与结算流程、价格规则、计算示例、失败与待核对的处理,以及充值与查看费用。
TokenToSea 按各厂商公布的官方价格计费,不加价、不收服务费。所有型号的费用都从同一个账户钱包扣除。本页说明一次调用的费用是怎样产生的,以及如何核对。
计费原则#
| 项目 | 规则 |
|---|---|
| 价格 | 厂商官方现行价格,保留原币:国内型号为人民币(CNY),海外型号为美元(USD)。少数型号标为暂定价,见暂定价格。 |
| 钱包 | 以美元(USD)记账,精确到 0.000001 美元。模型调用与工具调用共用同一个余额。 |
| 汇率 | 人民币价格在受理请求时按当时的参考汇率(ExchangeRate-API 公布的美元基准汇率)折算为美元,并写入本次调用的价格快照;结算使用同一汇率,不会在任务完成时改用新汇率。 |
| 舍入 | 预留与结算金额都保留 6 位小数并向上取整。 |
| 用量 | 以厂商在响应中报告的实际用量为准,平台不自行估算最终用量。 |
一次调用的资金流程#
| 阶段 | 发生了什么 | 对余额的影响 |
|---|---|---|
| 1. 受理 | 检查密钥、范围、限额与并发;冻结价格版本、汇率和计价条件 | — |
| 2. 预留 | 按本次请求可能产生的最大用量计算金额,从可用余额中冻结 | 可用余额减少,余额不变 |
| 3. 执行 | 请求发往厂商;流式输出实时转发 | — |
| 4. 结算 | 读取厂商报告的实际用量,按价格规则计算金额并扣除 | 余额减少实际金额 |
| 5. 释放 | 预留中未用完的部分退回可用余额 | 可用余额恢复 |
可用余额 = 余额 − 所有未结算调用的预留金额。可用余额不足以覆盖本次预留时,请求以 409 被拒绝,不会发往厂商。
同步请求在返回响应前已完成结算;流式请求在结算完成后才发出结束帧(见流式输出);异步任务在厂商任务完成后结算。
预留金额如何估算#
预留是保守上限,用来保证结算时一定有钱可扣:
| 计量项 | 预留时按 |
|---|---|
| 文本输入 token | 请求体字节数 + 4096(每个字节最多算一个 token);超过型号的最大输入 token 数时请求以 400 拒绝,见限制与配额 |
| 含图片、音频、视频或文件的输入 | 型号允许的最大输入量 |
| 输出 token | 请求中的 max_tokens / max_completion_tokens / max_output_tokens;未设置时按型号默认值(通常为 4096) |
| 视频、音频时长 | 请求中的 duration,或平台实际测得的输入媒体时长 |
| 图片数量 | 请求中的 n(默认 1) |
| 语音合成字符 | 输入文本字符数的 2 倍 |
同一型号有多条可能适用的价格规则时,预留取其中最高的一条。
实际结算通常远低于预留。几点建议:
- 设置合理的输出上限:
max_tokens越大,预留越多。 - 多模态请求预留较大:带图片或文件的请求按型号最大输入量预留,请保持足够的可用余额。
- 并发调用会同时占用预留:可用余额要覆盖所有并发请求的预留之和。
结算#
结算时,平台把厂商的 usage 规范化为计量项(如普通输入 token、缓存命中 token、输出 token、输出秒数、图片张数),再找出唯一符合条件的价格规则计算金额:
原币金额 = Σ(计量值 − 免费额度)× 费率 ÷ 计价单位
美元金额 = 原币金额 ÷ 受理时的汇率,保留 6 位小数并向上取整- 缓存命中的输入 token 按缓存价单独计费,不会再按普通输入重复计费。
- 结算金额不会自动超过预留金额;实际用量超出预留、缺少可核验的用量,或无法唯一匹配价格规则时,调用转入待核对。
- System One 型号只对输入 token 计费,输出免费。
- 实时音频会话在每轮响应完成后按厂商报告的累计用量分段结算。
价格规则#
每个型号的价格由一组规则组成。规则写明适用条件和若干计量项,例如:
| 常见条件 | 含义 |
|---|---|
input_length | 输入长度分档:不同长度区间使用不同费率 |
cache_mode | 隐式缓存或显式缓存 |
thinking | 是否开启思考 |
service_tier | 服务等级;平台按标准等级计价 |
resolution / duration | 视频或图片的分辨率、时长 |
billing_period | 时段价,例如 DeepSeek 的北京时间工作日高峰与非高峰;按受理时的时段计价 |
模型目录的每个型号页面都把规则渲染为表格,并附有厂商价格页链接与核对日期。也可以从 GET /v1/models 的 tariff 字段读取。
暂定价格#
少数型号暂未查到厂商公布的单价,平台以可比型号的最高价作为暂定价。这类型号在 GET /v1/models 中为 "pricing_status": "provisional",并在 pricing_basis 中给出参照型号;模型目录中也会标注。
免费型号#
部分型号的官方价格为 0(例如部分 Flash 型号),调用不扣费,但仍需有效密钥,并照常遵守并发与限额规则。
计算示例#
以 qwen3.8-flash 为例(2026-10-19 核对的标准隐式缓存价格,单位:人民币 / 百万 token):输入 0.8,缓存命中 0.1,输出 2.7。厂商返回:
{ "usage": { "prompt_tokens": 1200, "prompt_tokens_details": { "cached_tokens": 200 }, "completion_tokens": 300 } }| 计量项 | 数量 | 费率(CNY / 百万) | 金额(CNY) |
|---|---|---|---|
| 普通输入 token | 1,000 | 0.8 | 0.000800 |
| 缓存命中 token | 200 | 0.1 | 0.000020 |
| 输出 token | 300 | 2.7 | 0.000810 |
| 合计 | 0.001630 |
假设受理时的汇率为 1 USD = 7.10 CNY(仅为示意),则扣费为 0.001630 ÷ 7.10 = 0.0002295…,向上取整为 0.000230 USD。实际汇率与费率以本次调用的价格快照为准。
失败、退款与待核对#
| 情况 | 计费 |
|---|---|
| 请求在受理前被拒绝(参数、鉴权、余额、并发等) | 不预留、不计费 |
| 厂商明确拒绝(返回 4xx) | 不计费,预留立即释放 |
| 成功 | 按实际用量扣费,释放剩余预留 |
| 已预留但 5 分钟内未发往厂商 | 自动释放 |
| 结果或用量无法确认 | 进入待核对,预留暂不释放 |
待核对#
以下情况平台无法自动确定费用:厂商返回 5xx 或连接中断、流式输出不完整、响应缺少可核验的用量、异步任务超过 24 小时未完成等。此时:
- 调用状态为
needs_review,预留金额暂不释放,并计入账号的并发上限; - 平台工作人员依据厂商的真实回执人工核对,结论只有两种:按实际用量扣费,或全额释放;核对过程留有审计记录;
- 核对完成后,结果信封变为
succeeded或failed,可继续用原幂等键查询。
需要加快处理时,请在获取支持中提供 run_id 与幂等键。
查看费用#
推理响应只包含厂商的 usage,没有费用字段或费用响应头。查看金额:
- 控制台 → 账单:每笔入账与扣费流水,可导出 CSV;
- 控制台 → 我的 Key:每把密钥近 30 天的调用次数与费用;
- 控制台 → 模型测试:单次调用的扣费。
控制台按你选择的显示币种展示金额,余额显示到小数点后两位;账本内部仍按美元 6 位小数记录。
用密钥控制花费#
每把密钥可以设置滚动窗口内的 token 上限与金额上限,以及到期时间。限额在受理时按“已结算用量 + 进行中调用的预留 + 本次预留”检查。全能密钥的工具调用也计入同一限额。设置方法见认证与密钥。
充值#
| 方式 | 说明 |
|---|---|
| 微信支付 | 在充值页扫码,按人民币付款。下单时固定汇率并显示将入账的美元金额;付款成功后自动入账。付款码 30 分钟内有效。 |
| 对公转账 | 提交申请后按页面信息转账,平台人工核对到账后入账。 |
单笔充值 1–10,000 美元。