核心指南

账单与定价

费用预估、实际扣费、余额与限额说明

所有模型共用一份 TokenLab 余额。没有订阅,也没有最低消费。单次充值最低 $5。每笔费用都按模型价格和实际用量计算。

充值没有成功怎么办

只有状态为「已完成」的充值才会到账。状态是「处理中」或「失败」时,余额还没有加上。

  • 银行要求你验证这笔付款。 部分卡会由银行弹出验证窗口(验证码或手机银行确认)。请在同一个浏览器标签页里完成;标签页已关闭,就重新发起一次充值,出现验证时完成它。
  • 卡被拒绝。 换一张卡,或换用控制台里你所在国家可用的其他方式。卡本身有效也可能因为跨境或订阅类规则被银行拒付。
  • 充值一直停在处理中。 这是在等支付渠道或银行确认。同一笔金额没有结论前不要再发起第二笔;余额只会加一次。
  • 钱已扣但余额没到账。 写信到 hello@tokenlab.sh,写明日期、金额和卡号后四位。我们在系统里核对这笔付款后回复你。

加余额不需要 API key,也不需要发起请求;没有订阅,一笔充值只收一次。

交付方式

同一个模型、同一套 API 有两条线路:Verified 更便宜,Official 更稳定。交付方式决定请求走哪条线路、按哪种价格计费。

交付方式线路价格线路不可用时
Verified只走 Verified:TokenLab 验证的线路Verified 价格,多数模型低于 Official 价格请求失败,不收费
Official只走 Official:模型厂商或大平台Official 价格,即模型厂商公布的价格请求失败,不收费
Auto(默认)先走 Verified;Verified 没有供应或返回内容前出错时,改走 Official 一次按最终完成请求的线路计价由 Official 执行

模型页会并列显示每个模型的两种价格。

  • 每个完成的请求只扣一次费用。
  • 已经开始返回内容,或任务已被受理后,Auto 不再切换。
  • Auto 运行前按两条线路中较高的金额预留;若余额只够 Verified 估价、不够含 Official 的预留,本次只走 Verified,失败不再转 Official。结束后按实际费用结算,多余部分释放。
  • 请求头 X-TokenLab-Delivery-Policy 优先于 API 密钥设置,API 密钥设置优先于工作区默认。详见 API 简介。

需要确认的付费生成会在 Console 显示最高预估金额。完成后,Runs 和 Usage 会显示最终费用,以及实际完成请求的交付方式。

定价模式

模型价格可能变化。当前价格以 Console、模型页、GET /v1/models/:model/pricing 和 Pricing API 为准。

模型页的 Verified 价格或折扣显示“—”时,表示当前没有 Verified 报价,不代表免费。有 Official 供应的模型仍可通过 Official 或 Auto 使用。在 API 中,这类模型的 Verified 价格字段为 null 或不返回,实际支付的价格见 official_* 价格字段。交付方式的“支持”描述可选方式,实时可用性在每次请求时校验。模型系列价格仅汇总对应交付方式有供应的成员,不混合比较不同计费单位。

按 Token 计费

多数聊天、推理、嵌入、rerank 以及部分图像模型按输入、输出、缓存或图像输出 token 计费。

计费类型示例如何确认当前价格
Chat / Responsesgpt-5.4, claude-sonnet-4-6, gemini-3.6-flash模型页或 Pricing API
嵌入 / reranktext-embedding-3-small, qwen3-vl-rerank模型价格详情
按 token 计费的图像gpt-image-2GET /v1/models/gpt-image-2/pricing

不要把复制下来的价格表写死在代码里。应用需要展示或比较费用时,读取当前价格。

工具附加费

部分内置工具在 token 之外另行收费。只有模型实际使用了工具、且响应报告了使用次数时,TokenLab 才收取工具附加费。请求里提供了工具但模型没有使用,不收工具附加费。

工具模型计费方式
网页搜索OpenAI、Claude、Grok 模型,以及开启 Google 搜索 Grounding 的 Gemini 3 模型按模型执行的每次搜索计费;Gemini 3 按每条不重复的搜索词计费
搜索 Grounding开启 Google 搜索 Grounding 的 Gemini 2.5 模型每个经搜索 Grounding 的请求计一次
  • 每个模型的工具附加费分 Verified 和 Official 两档,与该模型的 token 价格一致。模型的价格详情里显示为网页搜索或搜索 Grounding。
  • 模型读取的搜索结果按该模型的输入 token 价格计费。
  • 某个模型没有配置价格的工具,不收费。
  • 在 Console 的 Runs 中打开一条请求,工具附加费一栏会显示调用次数和每次单价。API 密钥用量记录的 charged_price_basis 里也有相同信息:次数在 measure.dimensions.webSearchCalls 或 groundedPrompts,每次单价在 effectiveUnitPrices.webSearch 或 effectiveUnitPrices.groundedPrompt。

提示缓存

模型可以从缓存读取提示词中重复的开头部分。从缓存读取的 token 比普通输入 token 便宜。

  • GPT、Gemini 等部分模型会自动缓存重复的长提示词,无需设置。
  • Claude 模型只在你要求时缓存。在 Chat Completions 请求里加 "anthropic_options": {"prompt_caching": true},TokenLab 会把系统提示词的末尾和最新一条用户消息标为缓存点。使用 Messages API 时,请自己给内容块加 cache_control。
计费项与输入价格相比
写入缓存,5 分钟(默认)更高
写入缓存,1 小时("prompt_caching_ttl": "1h")比 5 分钟写入更高
读取缓存更低
  • 缓存价格因模型和交付方式而异,依赖某个比例前,请先在模型页或 Pricing API 查看该模型的缓存价格。
  • 从不重复的提示词开启缓存后,因为要写入缓存,会略贵一些。
  • 提示词短于模型的最低可缓存长度时不会被缓存,也不收写入费。
  • 不是每个模型都支持 1 小时缓存。模型没有列出时,请使用 5 分钟缓存。
  • 响应里可以看到结果:usage.prompt_tokens_details.cached_tokens 是从缓存读取的 token 数;usage.cache_creation_input_tokens 是写入缓存的 token 数,只在大于 0 时出现。

服务档位

TokenLab 按标准服务档位执行和计费。service_tier 接受 auto 和 default;flex、priority、fast、ultrafast 等其他值会被忽略,请求按标准档位执行,并按标准价格计费。

按请求和任务计费

图片、视频、音乐、3D、音频和 World 模型可能按次、张、秒、分钟或任务计费。模型页会写明计费单位。

家族示例
图像flux-pro-1.1
视频veo3.1, seedance-2.0
音乐suno-music
3Dtripo-h3.1
音频grok-tts, whisper-large-v3

异步任务计费

部分任务会在创建时预留预估费用。任务完成后只扣一次;任务失败时,待扣金额会释放或退回。

视频、音乐、3D 和异步图片生成会返回任务 ID 与 poll_url。任务变为 completed 或 failed 后记录最终金额。成功任务会在计费完成后返回 billing_transaction_id;失败任务不扣费。

任务结束后,如果 Usage 仍没有显示最终费用或释放金额,请把请求 ID 和任务 ID 发到 hello@tokenlab.sh。

billing_transaction_id

非流式 OpenAI 兼容响应如果在返回前完成结算,会带上 billing_transaction_id。同一个值也可能出现在 X-Billing-Transaction-ID 响应头中;Gemini 等原生格式可能只在响应头里提供。

异步任务完成结算后会返回 billing_transaction_id。流式响应可能早于结算结束;响应头里没有这个字段时,到 Usage 查询即可。

Token 数

文字模型通常会在 usage 中返回输入、输出和总 token 数。不同模型、语言和媒体输入的分词方式不同,按字符数估算并不可靠。费用请以当前模型价格和最终 Usage 记录为准。

查询用量

打开 Usage,可以找到:

  • 实时余额
  • 按模型分类的使用历史
  • 费用明细
  • 每把 API 密钥的用量

API 响应

按 Token 计费的响应通常会包含用量信息:

{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

少花一点

余额提醒

在 Console → Settings 设置余额阈值。余额低于阈值时,TokenLab 会发送邮件。

充值

打开 Console → Billing,选择金额和结账页显示的支付方式。支付平台确认成功后,余额会更新。

试用额度活动进行期间,符合条件的新账号可获得一次 $0.25 试用额度,最多调用 10 次,未用完的部分 7 天后过期。

想避免余额不足导致请求中断,可以在 Billing 里开启自动充值:余额低于你设定的金额时自动充值,不超过每月上限。

API 密钥限额

在 Console → API 密钥 创建或编辑密钥时,可以设置单独的费用上限。

达到上限后,使用这把密钥的请求会返回 402,错误码为 quota_exceeded。调高或取消上限即可继续。

402 也可能带错误码 insufficient_balance:账户余额低于本次请求的预估费用。错误体里带 balance_usd 和 estimated_cost_usd。在 Console → Billing 充值($5 起)后重试;充值前重复发同一个请求会一直失败。

请求错误

400 带 code=content_policy_violation 是内容安全拒绝,不是请求格式错:retryable=false,本次不计费。同一个提示原样重发会再被拒——要改的是输入(文字、图片或两者),不是重试。其他 400 会指明出错的 param,改那个字段再重试。

账单帮助

如有账单咨询,请联系 hello@tokenlab.sh。

本页内容