文档

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

快速开始

• TopxAI 是什么 · 一个 Base URL，七条线路上的 16 个模型，美元预付余额。TopxAI 不保存提示词和模型回复。
• 创建 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://api.topxai.xyz，模型选 claude-sonnet-5-5、claude-opus-5-5 或 claude-fable-5-2。
• Codex CLI 自定义模型供应商：在 config.toml 里写 model_providers 接 TopxAI · 在 ~/.codex/config.toml 里加一段 [model_providers.topxai]，一条命令或手工配置，把 Codex CLI 指到 TopxAI，用 gpt-6.1-sol、gpt-6-astra 或 grok-4.7；GitHub 和 npm 都够不着时还有 npm 镜像可用。
• Cursor 接 TopxAI：覆盖 OpenAI 基础地址 · 在 Cursor 里把 TopxAI 密钥填到 OpenAI 密钥栏，打开基础地址覆盖填 https://api.topxai.xyz/v1，再添加要聊天的模型 ID。
• Cline 和 Roo Code 接 TopxAI：OpenAI 兼容供应商 · 供应商选 OpenAI Compatible，基础地址填 https://api.topxai.xyz/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://api.topxai.xyz/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://api.topxai.xyz/v1 加为 OpenAI API 连接；模型列表从 /v1/models 读取，所有文本模型直接可聊。
• LobeChat 接 TopxAI：OpenAI 代理地址 · 在 LobeChat 里把 OpenAI 的 API 代理地址设为 https://api.topxai.xyz/v1，自部署用 OPENAI_PROXY_URL，然后拉取模型列表。
• Cherry Studio 接入 TopxAI：首次对话与端点设置 · 按密钥路由选择模型，区分 Cherry Studio 各版本的地址设置，排查首次调用。
• ChatBox 接 TopxAI：自定义服务商 · 在 ChatBox 里添加自定义服务商，API 模式选 OpenAI API 兼容，主机填 https://api.topxai.xyz，路径 /v1/chat/completions，再添加模型 ID。
• LangChain 接 TopxAI：langchain-topxai 包里的 ChatTopxAI · LangChain（Python）里装 langchain-topxai，用 ChatTopxAI 调 TopxAI 的文本模型。带 base URL 的 ChatOpenAI 照样能用，走 Responses API 也靠它。
• Vercel AI SDK 接 TopxAI：createOpenAI、createAnthropic 和 openai-compatible · 用 baseURL https://api.topxai.xyz/v1 和 TopxAI 密钥创建 AI SDK 供应商实例，然后用 generateText 或 streamText 调任意目录模型。
• LiteLLM 接 TopxAI：代理配置和 Python SDK · 用 model openai/<id> 和 api_base https://api.topxai.xyz/v1 把 LiteLLM 指到 TopxAI，写在代理的 model_list 或 completion() 调用里都行。
• Dify 接 TopxAI：OpenAI-API-compatible 供应商 · 通过 OpenAI-API-compatible 供应商把每个 TopxAI 模型加进 Dify：端点 https://api.topxai.xyz/v1、你的密钥、模型 ID。
• n8n 接 TopxAI：带 Base URL 的 OpenAI 凭据 · 在 n8n 里创建 OpenAI 凭据，Base URL 填 https://api.topxai.xyz/v1 加 TopxAI 密钥，然后在 Chat Model 和 AI Agent 节点里用任意目录模型。
• llm 命令行接 TopxAI：extra-openai-models.yaml · 在 llm 的 extra-openai-models.yaml 里登记 TopxAI 模型，api_base 填 https://api.topxai.xyz/v1，密钥用 llm keys set 存，然后在 shell 里直接提问。

线路与价格

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

模型

• Jev（TypeSafe System One） · Jev 1.14 返回什么、怎么用文字或图片调 POST /v1/systemone、Box 问题、TypeSafe 官方线路密钥下方那条一键接入命令、价格多少。
• GLM-5.3-Abliterated 与 GLM-5.3-Flash-Abliterated · GLM 线路的两个私有部署模型：只收文本的 GLM-5.3-Abliterated，和更快、能看图的 GLM-5.3-Flash-Abliterated。推理档位、上限和价格。
• 图片生成 · gpt-image-2.6-sunburst 和 -flare：两个端点、1K 与 2K 的单张价格、尺寸档位怎么定、图片链接从哪来。
• 视频生成 · grok-imagine-video-1.5：提交、轮询、按分辨率的每秒价格、失败退款，以及供应商已不认识的任务怎样在 24 小时后退款。
• deepseek-flash-Abliterated 与 deepseek-flash-fast · DeepSeek 线路的两个私有部署模型，都基于 DeepSeek V4.1 Flash 1017，一个去掉拒绝对齐，一个保留标准权重。上限、四种推理设置和全天固定价格。
• Kimi K3.1 Pro · 在 TopxAI 调用 kimi-k3.1-pro：私有部署、固定 token 价格、始终开启的推理（默认 low）、输出上限，以及图片和参数限制。
• Claude Opus 5.5 特价线路 · 一条经常不可用的临时低价 Claude Opus 5.5 线路：价格、怎样为它创建密钥、它额外加入的 Token，以及使用条款。

充值与余额

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

排查问题

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

对比

• TopxAI 与 OpenRouter：哪些一样，哪些不同 · 按注明日期的来源对照 TopxAI 与 OpenRouter 的模型价格、线路和接口，并说明私有部署价格的比较范围。
• TopxAI 与厂商官方接口：价格、留存，以及哪些仍要直连 · 通过 TopxAI 而不是厂商直接调用 Claude、GPT 或 Grok 时，什么变了：每个 token 的价格、一把密钥一个余额、零留存，以及哪些端点仍留在厂商那边。
• TopxAI 与 Vercel AI Gateway：按牌价不加价，还是牌价的一半 · Vercel AI Gateway 按厂商牌价收费、不加价；TopxAI 共享池的 Claude、GPT 和 Grok 只收牌价的 50%。其他差别也列在这里。

隐私与政策

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

TopxAI · 模型与价格 · 博客

其他语言：English