TopxAI

Loading...

文档 · 线路与价格

共享池、官方线路与自动路由

同一批模型,两种走法两种价:每条线路是什么意思,自动路由怎么替你选。

每个 API 密钥属于一条线路,也就是建密钥时的 分组 一栏(之后点 编辑 可以改)。线路决定请求怎么到达上游、按哪张固定美元价目表计费。模型本身没有区别。

线路有哪些

Claude、OpenAI、Grok 各有两条线路:

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 各只有一条线路,也没有共享池:

图像模型(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