核心指南
账单与定价
费用预估、实际扣费、余额与限额说明
所有模型共用一份 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 / Responses | gpt-5.4, claude-sonnet-4-6, gemini-3.6-flash | 模型页或 Pricing API |
| 嵌入 / rerank | text-embedding-3-small, qwen3-vl-rerank | 模型价格详情 |
| 按 token 计费的图像 | gpt-image-2 | GET /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 |
| 3D | tripo-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。