TokenToSea开发者文档
控制台

计费与结算

官方原价、币种与汇率、预留与结算流程、价格规则、计算示例、失败与待核对的处理,以及充值与查看费用。

本页内容

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。厂商返回:

JSON
{ "usage": { "prompt_tokens": 1200, "prompt_tokens_details": { "cached_tokens": 200 }, "completion_tokens": 300 } }
计量项数量费率(CNY / 百万)金额(CNY)
普通输入 token1,0000.80.000800
缓存命中 token2000.10.000020
输出 token3002.70.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,没有费用字段或费用响应头。查看金额:

控制台按你选择的显示币种展示金额,余额显示到小数点后两位;账本内部仍按美元 6 位小数记录。

用密钥控制花费#

每把密钥可以设置滚动窗口内的 token 上限与金额上限,以及到期时间。限额在受理时按“已结算用量 + 进行中调用的预留 + 本次预留”检查。全能密钥的工具调用也计入同一限额。设置方法见认证与密钥。

充值#

方式说明
微信支付在充值页扫码,按人民币付款。下单时固定汇率并显示将入账的美元金额;付款成功后自动入账。付款码 30 分钟内有效。
对公转账提交申请后按页面信息转账,平台人工核对到账后入账。

单笔充值 1–10,000 美元。

下一步#

    输入关键词搜索全部文档与模型。