文档 · 线路与价格
共享池、官方线路与自动路由
同一批模型,两种走法两种价:每条线路是什么意思,自动路由怎么替你选。
每个 API 密钥属于一条线路,也就是建密钥时的 分组 一栏(之后点 编辑 可以改)。线路决定请求怎么到达上游、按哪张固定美元价目表计费。模型本身没有区别。
线路有哪些
Claude、OpenAI、Grok 各有两条线路:
- 共享池(
claude-shared、openai-shared、grok-shared):官方标价的 50%。 - 官方线路(
claude-official、openai-official、grok-official):官方标价的 90%。官方线路没有专属渠道时,请求改由共享池服务,仍按官方线路的价格计费,日志里记fallback_group。
Claude 线路卖 claude-opus-5-5、claude-sonnet-5-5、claude-fable-5-1;OpenAI 线路卖 gpt-6-astra、gpt-6.1-sol;Grok 线路卖 grok-4.7,官方线路另带视频模型 grok-imagine-video-1.5,按秒计费。
Kimi、Jev、GLM 各只有一条线路,也没有共享池:
- Kimi:
kimi-official,kimi-k3按官方标价的 80% 计费。 - Jev(TypeSafe 的 System One 模型):
typesafe-official,TypeSafe 标价的 107%,走POST /v1/systemone。模型名jev-1.13.0,别名jev-latest、jev-preview按同一价格计费:每百万输入 token $0.04494,输出 $0。 - GLM:
z-official,私有部署的 GLM 5.3 微调版,只支持文本,价格高于基础模型的官方标价。
图像模型(gpt-image-2.5-sunburst、gpt-image-2.5-flare)在 image 线路上,按张计费。
输入、输出、缓存读取、缓存写入各有各的价,OpenAI 和 Grok 还有长上下文档位(分别从 272,001 和 200,000 个输入 token 起)。在分组列表里展开某条线路的模型数按钮,能看到它的 美元 / 每 100 万 tokens 价目表。
转发之前先过两道检查,没过都返回 HTTP 403、错误码 permission_denied,也不扣费:模型不在目录里,报错信息是 "Model is not offered by this service";模型不在密钥所在线路上卖,报错信息是 "Model is not available on this API key route"。
自动路由
建密钥时选 自动路由,一个密钥覆盖全部模型。每来一个请求,中继列出卖这个模型的线路(共享池、官方线路、单线路依次排列),从中挑当前能服务且价格最低的一条:先比每百万 token 的输入价,再比输出价;图像和视频比最便宜的尺寸或分辨率。价格相同时共享池优先。真正有得选的只有 Claude、OpenAI、Grok 的文本模型。
没配价格的线路直接跳过;一条都不剩时,返回上面那个 403。带价格的线路都没有可用渠道时,请求落到排第一的那条,返回 HTTP 503、错误码 upstream_unavailable,报错信息 "The model provider is temporarily unavailable. Please retry."。两种情况都不扣费。
按现行价目,Claude、OpenAI、Grok 的文本模型全部落在各自的共享池。用量日志在密钥名旁边显示实际计费的线路;auto_route: true 只出现在 API 返回的日志记录里,线路一栏永远不会写 auto。
需要专属的官方价线路,写信到 support@topxea.com。
相关
上一页:llm 命令行接 TopxAI:extra-openai-models.yaml · 下一页:请求怎么计费
其他语言:English