跳到主要内容

路由与 BYOK

Antix 是一个多协议网关。它接受 OpenAI、Anthropic 和 Gemini 数据结构的请求,并将跨越上游提供商的流式传输规范化,包括 Anthropic、Google Gemini、Alibaba Qwen、DeepSeek、Zai (GLM)、xAI 和 OpenAI。

支持的端点

端点方法协议
/v1/chat/completionsPOSTOpenAI Chat Completions
/v1/responsesPOSTOpenAI Responses API
/v1/messagesPOSTAnthropic Messages
/v1/messages/count_tokensPOSTAnthropic token counter
/v1/models/{action}POSTGemini 原生(:generateContent, :streamGenerateContent
/v1beta/models/{action}POSTGemini v1beta 原生路径
/v1/models, /modelsGET公开模型目录(无身份验证)
/v2/model/infoGET包含定价的目录

支持 /v1/embeddings、音频、图像、文件、微调(fine-tuning)和批处理(batch)API。

即插即用的 SDK 兼容性

通过更改基地址(base URL)并换上您的虚拟密钥,将任何 OpenAI、Anthropic 或 Gemini SDK 指向 Antix。代理会转换特定于提供商的特性,并保持 SSE 流的传输可预测。

from openai import OpenAI

client = OpenAI(
base_url="https://antix.antigma.ai/v1",
api_key="sk-antix-<your-key>",
)

response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Hello!"}],
stream=True,
)

流式传输管道将跨提供商的 SSE 事件标准化,因此无论上游情况如何,代币增量、工具调用和停止原因都将以一致的数据结构到达。

Claude Code

Claude Code 内部使用 Anthropic SDK,因此将其重定向到 Antix 只需要一个环境变量:

export ANTHROPIC_BASE_URL="https://antix.antigma.ai"

就是这样——Claude Code 的 SDK 会读取这两个配置,并将所有的 /v1/messages 流量路由到 Antix,Antix 在替换您的平台密钥后将其原样传递给 Anthropic。

自带密钥(Bring Your Own Key, BYOK)

如果您已经与提供商协商了直接费率,但仍然想要 Antix 的可观测性和路由功能,请使用 BYOK。在 Authorization 中发送您的提供商密钥,并通过 X-Antix-Provider 声明提供商:

curl -X POST https://antix.antigma.ai/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ALIBABA_DASHSCOPE_KEY" \
-H "X-Antix-Provider: alibaba" \
-d '{
"model": "qwen-max",
"messages": [{"role": "user", "content": "Hello!"}]
}'

Antix 不会对 BYOK 流量重新计费。为了可观测性,它仍会被追踪记录。

支持的提供商

Antix 在这些上游提供商之间将请求标准化。您可以通过模型名称(Antix 会推断提供商)或通过 X-Antix-Provider 明确地路由到其中的任何一个:

提供商显著的模型可接受的 X-Antix-Provider备注
AnthropicClaude Sonnet, Opus, Haikuanthropic原生 /v1/messages 支持。
OpenAIGPT-5.xopenai原生 /v1/chat/completions/v1/responses 支持。
Google GeminiGemini 3.xgoogle, gemini, google_ai_studio_gemini/v1/models/{action}/v1beta 的原生 Gemini 协议。
xAIGrokxai, x-ai兼容 OpenAI 的上游。
Alibaba Qwenqwen3-max, qwen3-coder-plus, qwen3-coder-flash, qwq-plus, qwen-plus, qwen-max, 等等alibaba, qwen, dashscope通过 DashScope 路由。没有独特的密钥前缀——您必须在 BYOK 调用中设置 X-Antix-Provider
DeepSeekdeepseek-chat (V3), deepseek-reasoner (R1), deepseek-v4-pro, deepseek-v4-flashdeepseek兼容 OpenAI 的上游 API。deepseek-reasoner 会在最终答案旁返回 reasoning_content 字段。
Zai (GLM)glm-5.2, glm-5.1, glm-4.7zai智谱 AI 的 GLM 模型系列,兼容 OpenAI 的上游。没有独特的密钥前缀——您必须在 BYOK 调用中设置 X-Antix-Provider
提供商推断

当标头被省略时,Antix 会从密钥前缀推断提供商(例如,sk-ant-… → Anthropic,sk-… → OpenAI)。某些密钥(如 Alibaba/DashScope 或 Zai)可能没有明显的前缀——您必须为这些请求设置 X-Antix-Provider,否则它们在上游将因 401 Unauthorized 失败。

请参阅模型 API以准确列出您的网关目前提供服务的模型。