文档 · 快速开始
API 参考：全部端点，附 OpenAPI 规范
TopxAI 提供的端点、各自接受和返回什么、密钥的两种发送方式，以及给 SDK 生成器和 API 工具用的 OpenAPI 3.1 文件 /openapi.json。
TopxAI 为下表所列模型提供兼容 OpenAI 和 Anthropic 的端点。兼容范围取决于模型和端点：部分请求使用厂商原生格式，部分会进行协议转换，文档列出的字段也可能被调整或移除。某个端点可用，不代表全部 SDK 功能或服务端会话存储都可用。
这一页用于选择端点、配置鉴权和了解转换限制。厂商接口对比列出字段与系统提示的调整；LangChain 指南解释 Claude 的 JSON Schema 与工具选择限制。/openapi.json是供 API 工具和代码生成器使用的 OpenAPI 3.1 规范。
基础地址
https://api.topxai.xyz/v1：OpenAI 风格的 SDK 和工具，它们自己拼/chat/completions、/responses、/images/…、/models。https://api.topxai.xyz：Anthropic SDK，它自己拼/v1/messages。
鉴权
密钥页创建的 TopxAI 密钥（sk-…），两种发法：
- 所有端点都接受
Authorization: Bearer <key>。 /v1/messages还接受x-api-key: <key>，Anthropic SDK 就是这么发的。
密钥的线路决定它能调哪些模型；自动路由的密钥能调全部模型。
端点
| 端点 | 格式 | 模型 | 说明 |
|---|---|---|---|
POST /v1/chat/completions |
OpenAI Chat Completions | 除 Jev 外的全部文本模型 | stream: true 走 SSE |
POST /v1/responses |
OpenAI Responses | gpt-6-astra、gpt-6.1-sol、gpt-6.1-terra、grok-4.7、GLM-5.3-Flash-Abliterated、kimi-k3.1-pro、deepseek-flash-Abliterated、deepseek-flash-fast | Codex CLI 用的就是它 |
POST /v1/messages |
Anthropic Messages | 除 Jev 外的全部文本模型 | Claude 走原生格式，其他模型先转换（见下文）；anthropic-version 可以不带 |
POST /v1/images/generations |
OpenAI Images | gpt-image-2.6-sunburst、gpt-image-2.6-flare | 按 size 档位每张计价；n 取 1 到 128 |
POST /v1/images/edits |
OpenAI Images（multipart） | 同上两个 | 计价同生成 |
POST /v1/videos/generations |
视频任务 | grok-imagine-video-1.5 | duration 1 到 15 秒，resolution 480p/720p/1080p；受理即扣费 |
GET /v1/videos/{request_id} |
任务状态 | pending、queued、processing、running、in_progress 继续轮询 | |
GET /v1/videos/{request_id}/content |
视频文件 | done 之后 |
|
POST /v1/systemone |
TypeSafe System One | jev-1.14.0、jev-latest、jev-preview | model、state、questions；图片放在 assets，base64 或 multipart 文件段都行；/v1/system_one 也可以 |
GET /v1/models |
OpenAI 模型列表 | 按密钥线路过滤 | |
GET /api/pricing |
JSON 价格表 | 不需要密钥；/pricing 背后的数据 |
/v1/responses 上的私有部署模型（GLM-5.3-Flash-Abliterated、kimi-k3.1-pro 和两个 DeepSeek 模型）接受无状态请求，请在 input 中发送完整对话。它们的服务端会话持久化和完整 Codex 工作流尚未验证。两个 DeepSeek 模型没写 max_output_tokens 时，TopxAI 按模型的输出上限补上（deepseek-flash-Abliterated 是 131,072 token，deepseek-flash-fast 是 262,144 token），但不超过上下文窗口减去估算提示词后剩下的长度。详见 GLM、Kimi 和 DeepSeek 的模型指南。
模型兼容范围与验证
本表于 2026-11-08 对照当前目录及所链接的模型指南核对，说明已记录的支持范围和已知限制，不代表当天重新实测了每个模型、每个客户端版本。请使用价格表中的精确模型 ID，迁移业务前先验证应用依赖的功能。
| 模型或系列 | 使用的接口 | 功能与限制 | 配置或依据 |
|---|---|---|---|
| Claude Fable 5.2、Sonnet 5.5、Opus 5.5 | Claude 原生功能用 Messages；OpenAI 客户端用 Chat Completions | 支持流式和工具调用，但拒绝强制工具选择。Chat JSON Schema 会转换为 Claude 支持的子集。原生 Messages 保留缓存断点。 | Claude Code 配置、结构化输出示例与限制 |
| GPT-6 Astra、GPT-6.1 Sol 和 Terra、Grok 4.7 | Chat Completions 或 Responses；Messages 会转换 | 支持流式。跨协议调用可能改变推理和工具结果的表示，适用下方转换规则。端点可用不代表每项 SDK 参数都经过验证。 | SDK 示例、字段调整 |
| Kimi K3.1 Pro | Chat Completions、无状态 Responses、转换后的 Messages | 私有部署。多轮请求须保留推理和工具调用字段。图片使用 base64 data URI，不支持公共 HTTP 图片地址。stop、json_schema、tool_choice 的 none 和 required、parallel_tool_calls: false 不起作用；不支持 n，不返回 logprobs。 |
Kimi 指南 |
| deepseek-flash-Abliterated、deepseek-flash-fast | Chat Completions、无状态 Responses、转换后的 Messages | 支持文本、图片输入和流式的私有部署。deepseek-flash-fast 只收 base64 图片，stop、json_schema、tool_choice 的 none 和 required、parallel_tool_calls: false 在它上面不起作用。不支持 n，不返回 logprobs。须发送完整对话上下文，不承诺服务端持久化。 |
DeepSeek 指南与请求示例 |
| GLM-5.3-Abliterated、GLM-5.3-Flash-Abliterated | Chat Completions 或转换后的 Messages；GLM-5.3-Flash-Abliterated 另有无状态 Responses | 私有部署。GLM-5.3-Abliterated 只收文本，附件会替换为文字说明，部分 JSON Schema 字符串格式改为描述提示。GLM-5.3-Flash-Abliterated 收 base64 图片。不支持 n，不返回 logprobs。 |
GLM 指南 |
| Jev 1.14.0 | System One | 使用独立请求格式处理带类型的问题和回答，不是 Chat Completions、Responses 或 Messages 模型。 | Jev 请求示例 |
最小联调可以先跑SDK 请求示例，再逐项打开流式或加入一个工具、schema、图片。普通文本回复成功不能证明其他功能也成功。报告结果时记录模型、线路、客户端版本、日期和请求 ID，不要公开密钥或私密提示词。
用 Messages 调其他模型
Claude 模型收到的 /v1/messages 请求还是 Anthropic 自己的格式，cache_control 断点也都在；中继途中改动的几个字段（比如没写 max_tokens 时补上模型的输出上限）列在与厂商官方接口的对照里。请求没带 anthropic-version 时，中继按 2023-06-01 发给 Claude；转换后的请求不带这个请求头。其他文本模型的请求，TopxAI 会先转换：gpt-6.1-sol 和 gpt-6.1-terra 转成 Responses API，gpt-6-astra、grok-4.7、kimi-k3.1-pro、GLM-5.3-Abliterated、GLM-5.3-Flash-Abliterated、deepseek-flash-Abliterated、deepseek-flash-fast 转成 Chat Completions。两种情况下，回答都会转回 Messages 响应或事件流。走转换的这些模型和 Claude 有几处不同：
- 不带
max_tokens时，两个 DeepSeek 模型同样按模型的输出上限发，但不超过上下文窗口减去估算提示词后剩下的长度：deepseek-flash-Abliterated是 131,072 token，deepseek-flash-fast是 262,144 token。其余走转换的模型不加上限，输出长度按厂商自己的默认值。 - 转成 Chat Completions 时，只保留消息里文本、图片和文档块上的
cache_control，其余位置的都去掉：系统提示、工具定义、tool_use和tool_result块。转成 Responses（gpt-6.1-sol、gpt-6.1-terra）时全部去掉。 - 在走 Chat Completions 的模型上，
tool_result里的文本留在 tool 消息上，图片移到工具结果后面那条 user 消息里；tool_result里带文档返回 400。转成 Responses 时两者都会传给 gpt-6.1-sol 和 gpt-6.1-terra。 - 对话历史里的
thinking块（包括模型自己此前回答里返回的那些）在发给 gpt-6.1-sol 或 gpt-6.1-terra 之前会去掉；走 Chat Completions 的模型把这些块当作推理内容收下。redacted_thinking块在所有走转换的模型上都会去掉。去掉的推理，模型接着回答时就看不到了。 - grok-4.7 每次请求都会推理，而 xAI 不接受推理模型带停止序列，所以 grok-4.7 的请求带
stop_sequences会返回 400，错误消息写明是哪个参数。 - GLM-5.3-Abliterated 只收文字。在
/v1/chat/completions和/v1/messages上，附件都会换成一段说明文字，详见模型页面。
状态码
400 请求体校验失败，消息里写明字段；System One 上也可能是 TypeSafe 自己的拒绝说明，原样转给你。401 密钥缺失或无效。402 余额为零。403 模型不在售、不在这把密钥的线路上，或被密钥的模型限制排除。404 厂商回答模型不存在，或视频任务 ID 未知。413 System One 的请求体或图片超过大小限制。422 TypeSafe 的校验详情（只有 System One）。429 触发限速，Retry-After 给出秒数。503 当前没有线路能提供该模型，重试。每条错误消息末尾都有请求 ID，联系 support@topxai.xyz 时带上。
使用规范文件
curl -O https://api.topxai.xyz/openapi.json把文件导入 Postman 或 Insomnia，每个端点各得一个填好示例的请求；或者交给 openapi-generator 生成带类型的客户端。文件里的 servers 是生产域名，不含任何密钥或账号信息。
不提供的
批处理、微调、文件、assistants、向量库、实时、音频、向量这些不转发，请求这些路径返回 404，继续用厂商自己的密钥。与厂商官方接口的对照列出了其他仍要直连的部分。
相关
上一页：接入你的 SDK · 下一页：Claude Code 接 TopxAI：ANTHROPIC_BASE_URL 和密钥
其他语言：English