文档 · 线路与价格
请求怎么计费
计费单位、长上下文档位、请求开始时的预留额度,以及请求失败后预留怎么处理。
每个请求只按一张固定的美元价目计费:你的密钥所在线路上这个模型的价格,模型页上列的就是它(自动路由的密钥按本次请求选中的线路计费)。价格在转发之前锁定,之后改价不影响已经开始的请求。模型在你的线路上没配价格,请求直接拒绝,返回 HTTP 400、错误码 invalid_request,报错信息 "model ... has no configured USD price for this API key route"。
计费单位
文本模型按每百万 token 计费,各条通道单独定价:输入、输出、缓存读取、缓存写入(Claude 另有 1 小时缓存写入价)。命中缓存的 token 不算普通输入;某条通道没有单独定价,就按输入价算。Jev 只收输入费,输出 $0。
图像模型按张计费,分两档:1k(不超过 1024x1024)和 2k(不超过 2048x2048)。不传尺寸或传 auto,按 1024x1024 处理;上游返回的尺寸比请求的大,结算时按大的那档收。两个 gpt-image-2.5-* 模型都是 1K 每张 $0.03、2K 每张 $0.05,n 是几就乘几。
grok-imagine-video-1.5 按秒计费:480p 每秒 $0.05(默认分辨率)、720p $0.10、1080p $0.20;时长 1 到 15 秒,默认 8 秒。
长上下文档位
OpenAI 和 Grok 模型对长提示词另有一档价格:总输入上下文(提示词加缓存 token)达到 272,001 个 token(gpt-6-astra、gpt-6.1-sol)或 200,000 个 token(grok-4.7),整个请求都按长上下文通道结算,不是只算超出的部分。Claude、Kimi、GLM、Jev 没有这一档。走不走这一档,结算时才定。
高峰时段
DeepSeek 模型(deepseek-flash、deepseek-v4-pro)有两套完整价目。请求在上游的高峰时段(北京时间周一至周五 09:00–12:00 与 14:00–18:00,即 UTC 01:00–04:00 与 06:00–10:00,价格页会换算成你所在时区显示;中国法定节假日除外)被受理时按高峰价计费;其余时间、周末与法定节假日全天为空闲时段,价格是高峰价的一半。档位在 relay 受理请求时冻结,跨越边界的长流式请求按受理时的档位结算。用量日志的每一行都标明适用档位,计费明细列出实际按哪一档单价扣费。
预留与结算
请求开始时,中继先按锁定的价格预留一笔估算额度:提示词 token 加上你设的输出上限(max_tokens,Chat Completions 也认 max_completion_tokens,Responses API 用 max_output_tokens;都没设按 8,192 算)。没设上限时,模型最多可以写到它自己的输出上限;预留仍按 8,192 算,结算按实际写出的收费。图像和视频按整单预留:每张单价乘以 n,或每秒单价乘以时长。余额或密钥剩余额度不够预留时,请求以 HTTP 402 拒绝,不转发:
{
"error": {
"message": "Insufficient quota. Top up your balance and try again. (request id: ...)",
"type": "insufficient_quota",
"code": "insufficient_quota",
"param": null
}
}
走 /v1/messages 时,同一个拒绝的响应体是 {"type":"error","error":{"type":"billing_error","message":"..."}}。
响应结束后按实际用量算出费用,差额退回余额;实际用量高出估算时,多出的部分补扣。没等到结算的预留,5 分钟租约到期后自动退回。
上游报错或超时,预留全额释放,日志里记一行错误,费用为零;中继会换一个渠道重试一次,只对最后一次尝试收费。流式请求已经生成了输出的另算:流中途断开,或者供应商写到一半报错,已经生成的部分只收一次费,按供应商报的用量算,没报就按中继数出的文字加上估算的提示词算,剩下的预留退回(客户端收到什么,见常见错误响应)。另外还有三处例外:图像、视频和 Jev(/v1/systemone)请求在客户端断开后最多再跑 4 分钟,跑完照常结算而不退款,因为上游对已接受的任务照样收费。视频任务失败、过期或实际时长不足,事后退款(全退,或退没交付的秒数),日志里多一行退款。Grok 的儿童安全检查拒掉的请求(包括流式回答写到一半才被拒的),先退预留,再单独扣 $0.05 违规费,日志里单独记一行,标着违规扣费。
相关
上一页:共享池、官方线路与自动路由 · 下一页:看懂用量日志
其他语言:English