文档

TopxAI 文档：接入方法、各线路计价、充值方式和请求失败的排查。

快速开始

TopxAI 是什么 · 一个 Base URL，七条线路十四个模型，美元预付余额，不保存你发送的内容。
创建 API 密钥并选择线路 · 密钥抽屉的填写步骤、每条线路的含义，以及一把密钥会碰到的三种 403。
接入你的 SDK · Base URL、各接入点及其鉴权头、OpenAI SDK 和 Anthropic SDK 的可用示例，以及每个错误状态码的含义。
API 参考：全部端点，附 OpenAPI 规范 · TopxAI 提供的端点、各自接受和返回什么、密钥的两种发送方式，以及给 SDK 生成器和 API 工具用的 OpenAPI 3.1 文件 /openapi.json。

接入指南

Claude Code 接 TopxAI：ANTHROPIC_BASE_URL 和密钥 · 两个环境变量把 Claude Code 指到 https://ai.topxea.com，模型选 claude-sonnet-5-5、claude-opus-5-5 或 claude-fable-5-1。
Codex CLI 接 TopxAI：下载、安装、配置 · 经 GitHub 和 npm 都够不着时也能用的 npm 镜像拿到 Codex CLI，一条命令装好并写入 ~/.codex/config.toml，然后用 gpt-6.1-sol、gpt-6-astra 或 grok-4.7 跑 Codex。
Cursor 接 TopxAI：覆盖 OpenAI 基础地址 · 在 Cursor 里把 TopxAI 密钥填到 OpenAI 密钥栏，打开基础地址覆盖填 https://ai.topxea.com/v1，再添加要聊天的模型 ID。
Cline 和 Roo Code 接 TopxAI：OpenAI 兼容供应商 · 供应商选 OpenAI Compatible，基础地址填 https://ai.topxea.com/v1，加 TopxAI 密钥和模型 ID；Claude 也可以走带自定义地址的 Anthropic 供应商。
Continue 接 TopxAI：config.yaml 里的模型 · 在 ~/.continue/config.yaml 里用 provider openai 或 anthropic 加 apiBase 添加 TopxAI 模型，VS Code 和 JetBrains 里的聊天、编辑、agent 模式都能用。
Zed 接 TopxAI：OpenAI 兼容与 Anthropic 兼容供应商 · 在 settings.json 里把 TopxAI 加为 openai_compatible 供应商（GPT、Grok、Kimi、GLM）和 anthropic_compatible 供应商（Claude）。
Aider 接 TopxAI：OPENAI_API_BASE 和模型名 · 用 OPENAI_API_BASE=https://ai.topxea.com/v1 和 --model openai/claude-sonnet-5-5 让 aider 走 TopxAI；Claude 线路也可以用 Anthropic 的变量。
opencode 接 TopxAI：opencode.json 里的自定义供应商 · 在 opencode.json 里用 @ai-sdk/openai-compatible 声明 TopxAI，写上基础地址和模型 ID，然后用 /models 选择。
Open WebUI 接 TopxAI：一个 OpenAI 连接，全部模型 · 在 Open WebUI 里把 https://ai.topxea.com/v1 加为 OpenAI API 连接；模型列表从 /v1/models 读取，所有文本模型直接可聊。
LobeChat 接 TopxAI：OpenAI 代理地址 · 在 LobeChat 里把 OpenAI 的 API 代理地址设为 https://ai.topxea.com/v1，自部署用 OPENAI_PROXY_URL，然后拉取模型列表。
Cherry Studio 接入 TopxAI：首次对话与端点设置 · 按密钥路由选择模型，区分 Cherry Studio 各版本的地址设置，排查首次调用。
ChatBox 接 TopxAI：自定义服务商 · 在 ChatBox 里添加自定义服务商，API 模式选 OpenAI API 兼容，主机填 https://ai.topxea.com，路径 /v1/chat/completions，再添加模型 ID。
LangChain 接 TopxAI：带 base URL 的 ChatOpenAI 和 ChatAnthropic · LangChain（Python 和 JavaScript）里给 ChatOpenAI 传 base_url 就能用全部文本模型，给 ChatAnthropic 传则是带提示缓存的 Claude。
Vercel AI SDK 接 TopxAI：createOpenAI、createAnthropic 和 openai-compatible · 用 baseURL https://ai.topxea.com/v1 和 TopxAI 密钥创建 AI SDK 供应商实例，然后用 generateText 或 streamText 调任意目录模型。
LiteLLM 接 TopxAI：代理配置和 Python SDK · 用 model openai/<id> 和 api_base https://ai.topxea.com/v1 把 LiteLLM 指到 TopxAI，写在代理的 model_list 或 completion() 调用里都行。
Dify 接 TopxAI：OpenAI-API-compatible 供应商 · 通过 OpenAI-API-compatible 供应商把每个 TopxAI 模型加进 Dify：端点 https://ai.topxea.com/v1、你的密钥、模型 ID。
n8n 接 TopxAI：带 Base URL 的 OpenAI 凭据 · 在 n8n 里创建 OpenAI 凭据，Base URL 填 https://ai.topxea.com/v1 加 TopxAI 密钥，然后在 Chat Model 和 AI Agent 节点里用任意目录模型。
llm 命令行接 TopxAI：extra-openai-models.yaml · 在 llm 的 extra-openai-models.yaml 里登记 TopxAI 模型，api_base 填 https://ai.topxea.com/v1，密钥用 llm keys set 存，然后在 shell 里直接提问。

线路与价格

共享池、官方线路与自动路由 · 同一批模型，两种走法两种价：每条线路是什么意思，自动路由怎么替你选。
请求怎么计费 · 计费单位、长上下文档位、请求开始时的预留额度，以及请求失败后预留怎么处理。
看懂用量日志 · 日志里每一行写了什么、怎么筛选，以及哪些内容永远不会记录。

模型

Jev（TypeSafe System One） · Jev 返回什么、怎么调 POST /v1/systemone、TypeSafe 官方线路密钥下方那条一键接入命令、价格多少。
GLM-5.3-Abliterated · 私有部署上的 GLM 5.3 微调版：只收文本，100 万 token 上下文，三档推理，价格高于牌价，附带合规声明。
图片生成 · gpt-image-2.5-sunburst 和 -flare：两个端点、1K 与 2K 的单张价格、尺寸档位怎么定、图片链接从哪来。
视频生成 · grok-imagine-video-1.5：提交、轮询、按分辨率的每秒价格、失败退款，以及供应商已不认识的任务怎样在 24 小时后退款。

充值与余额

用银行卡充值 · 用银行卡、Apple Pay、Google Pay 或本地电子钱包充值美元余额，结账在 topxea.com 经 Waffo 完成。
用加密货币充值 · 通过 NOWPayments 收银台用 USDT 或 USDC 充值：转什么、多久确认、少付了怎么办。
储值卡与兑换码 · 购买一次性兑换码、在任意账号兑换，以及用户协议里的退款条款。

排查问题

常见错误响应 · 网关返回的每个状态码和错误码是什么意思，重试前该改什么。
curl 能跑通，工具里却报错 · 工具和能跑通的 curl 通常差在七处，逐一对照就能找到。
登录与账户 · 登录如何与 topxea.com 共用，会话、设备和 TopxAI Desktop 登录怎么管，地区服务说明，以及怎么找客服。

对比

TopxAI 与 OpenRouter：哪些一样，哪些不同 · 按模型和线路比较实际价格：TopxAI 共享池比 OpenRouter 标准线路便宜 37.5% 到 50%，Kimi 有托管商比 TopxAI 更便宜。
TopxAI 与厂商官方接口：价格、留存，以及哪些仍要直连 · 通过 TopxAI 而不是厂商直接调用 Claude、GPT、Grok 或 Kimi 时，什么变了：每个 token 的价格、一把密钥一个余额、零留存，以及哪些端点仍留在厂商那边。

隐私与政策

TopxAI 存什么，不存什么 · 请求正文只在内存里经过；用量日志、账户和支付记录各留什么、留多久。
可接受使用与滥用举报 · 六类禁止内容、处理措施怎么定、GLM 私有部署为何不例外，以及怎么举报。

TopxAI · 模型与价格 · 博客

其他语言：English