快速开始

MaxRouter 提供统一的 OpenAI 兼容接口，一个 API Key 即可访问 GPT、Claude、Gemini、DeepSeek 等主流大模型。

curl https://api.maxrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Base URL & 认证

Base URL

兼容 OpenAI SDK，只需替换 base_url 即可无缝切换。

认证方式

所有请求需在 Header 中携带 API Key：

Authorization: Bearer sk-your-api-key

Chat Completions

请求参数

请求示例

curl https://api.maxrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手"},
      {"role": "user", "content": "用 Python 写一个快速排序"}
    ],
    "temperature": 0.7,
    "max_tokens": 2048
  }'

响应格式

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "claude-sonnet-4.6",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "你好！有什么可以帮你的吗？" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 8, "completion_tokens": 12, "total_tokens": 20 }
}

流式输出

设置 stream: true 启用 SSE（Server-Sent Events）流式输出，实时获取模型生成内容。

curl https://api.maxrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "messages": [{"role": "user", "content": "写一首关于编程的诗"}],
    "stream": true
  }'

流式数据格式

每个 SSE 事件以 data: 开头，最后一条为 data: [DONE]：

data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"你"},"index":0}]}

data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"好"},"index":0}]}

data: [DONE]

模型列表

查看 完整模型列表与实时价格，也可通过 API 获取：

curl https://api.maxrouter.ai/v1/models \
  -H "Authorization: Bearer sk-your-key"

常用模型

价格以美元计，完整列表请查看 模型页面。

错误码

API 返回标准 HTTP 状态码，错误响应包含 JSON 格式的详细信息：

{ "error": { "message": "余额不足", "type": "insufficient_quota" } }

使用限制

如需更高配额，请联系客服。查看 用量统计 了解当前使用情况。

OpenAI 接口

MaxRouter 默认使用 OpenAI 兼容接口，所有支持 OpenAI SDK 的工具和框架均可直接对接。

使用 OpenAI 官方 SDK，只需修改 base_url 和 api_key，无需安装额外依赖：

curl https://api.maxrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

Anthropic 接口

MaxRouter 同时支持 Anthropic Messages API 原生格式，Claude Code 等工具可直接连接。

支持的 Claude 模型

以下模型可通过 Anthropic 接口直接使用，发送原生模型名即可自动映射：

请求示例

curl https://api.maxrouter.ai/v1/messages \
  -H "x-api-key: sk-your-key" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Claude Code

Claude Code 是 Anthropic 官方的终端 AI 编程助手，支持通过环境变量配置自定义 API 端点。

第一步：获取 API Key

登录 MaxRouter，进入 控制台 → API Key 管理，点击「创建令牌」，复制生成的密钥。

第二步：安装 Claude Code

npm install -g @anthropic-ai/claude-code

第三步：配置环境变量

编辑 ~/.zshrc（macOS 默认 Shell）：

# 打开配置文件
nano ~/.zshrc

# 在文件末尾添加以下两行
export ANTHROPIC_BASE_URL=https://api.maxrouter.ai
export ANTHROPIC_API_KEY=sk-your-key

# 保存后使配置生效
source ~/.zshrc

第四步：验证连接

# 启动 Claude Code
claude

# 进入后输入任意问题测试
> 你好，请介绍一下自己

如果正常返回回复，说明配置成功。可在 用量统计 中查看调用记录。

Cursor

Cursor 是基于 VS Code 的 AI 代码编辑器，支持自定义 OpenAI 兼容 API。

第一步：获取 API Key

登录 MaxRouter，进入 控制台 → API Key 管理，创建并复制密钥。

第二步：打开设置

在 Cursor 中，点击左下角齿轮图标 → Settings → Models。

第三步：配置 API

勾选你需要使用的模型（如 claude-sonnet-4.6、gpt-4.1 等），点击 Save。

第四步：验证

在编辑器中按 Ctrl+L（macOS: Cmd+L）打开 AI 对话，发送任意消息测试。在 用量统计 中确认调用记录。

Windsurf

Windsurf（原 Codeium）是 AI 代码编辑器，支持自定义 OpenAI 兼容端点。

第一步：获取 API Key

登录 MaxRouter，进入 控制台 → API Key 管理，创建并复制密钥。

第二步：打开设置

在 Windsurf 中，点击左下角齿轮图标 → Settings → 搜索 AI Provider。

第三步：配置 API

第四步：验证

在编辑器中使用 AI 功能发送任意消息测试。在 用量统计 中确认调用记录。

Kiro

Kiro 是 AWS 推出的 AI IDE，支持通过 MCP 配置自定义 API 端点。也可以通过配置 Anthropic 兼容端点使用。

第一步：获取 API Key

登录 MaxRouter，进入 控制台 → API Key 管理，创建并复制密钥。

第二步：配置模型

Kiro 支持自定义模型配置。在 Kiro 设置中找到模型配置选项，添加 OpenAI 兼容端点：

第三步：验证

在 Kiro 中发送任意消息测试连接。在 用量统计 中确认调用记录。

OpenCode

OpenCode 是开源的终端 AI 编程助手，支持 OpenAI 兼容 API。

第一步：获取 API Key

登录 MaxRouter，进入 控制台 → API Key 管理，创建并复制密钥。

第二步：安装 OpenCode

# macOS (Homebrew)
brew install opencode-ai/tap/opencode

# 或使用 Go 安装
go install github.com/opencode-ai/opencode@latest

第三步：配置

在项目根目录创建 opencode.json：

{
  "provider": {
    "name": "openai",
    "apiKey": "sk-your-key",
    "baseURL": "https://api.maxrouter.ai/v1",
    "model": "claude-sonnet-4.6"
  }
}

第四步：验证

opencode

启动后输入任意问题测试。在 用量统计 中确认调用记录。

ChatBox / NextChat

ChatBox 和 NextChat 是流行的桌面/Web AI 聊天客户端，均支持 OpenAI 兼容 API。

ChatBox 配置

打开 ChatBox → 设置 → AI 模型提供商 → 选择 OpenAI API：

NextChat 配置

打开 NextChat → 设置 → 自定义接口：

配置完成后，在对话中选择模型即可使用。前往 API Key 管理 获取密钥。

LangChain / LlamaIndex

主流 AI 开发框架均支持 OpenAI 兼容 API，只需修改 Base URL 即可接入 MaxRouter。

LangChain (Python)

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-sonnet-4.6",
    api_key="sk-your-key",
    base_url="https://api.maxrouter.ai/v1"
)

response = llm.invoke("用 Python 写一个快速排序")
print(response.content)

LlamaIndex (Python)

from llama_index.llms.openai_like import OpenAILike

llm = OpenAILike(
    model="claude-sonnet-4.6",
    api_key="sk-your-key",
    api_base="https://api.maxrouter.ai/v1"
)

response = llm.complete("用 Python 写一个快速排序")
print(response.text)

LangChain (Node.js)

import { ChatOpenAI } from "@langchain/openai";

const llm = new ChatOpenAI({
  modelName: "claude-sonnet-4.6",
  openAIApiKey: "sk-your-key",
  configuration: { baseURL: "https://api.maxrouter.ai/v1" }
});

const response = await llm.invoke("用 Python 写一个快速排序");
console.log(response.content);

更多框架的接入方式类似，只要支持 OpenAI 兼容 API 的框架都可以通过修改 Base URL 接入。