接入文档

快速开始

登录本站账号后，先在钱包联系管理员充值，再创建一把 API Key。创建时必须选择线路分组；这把 Key 只能请求该分组中的模型，并使用该分组对应的价格和线路。

1. 在“钱包”选择价位并联系管理员完成充值。
2. 在“API Key”选择线路分组并创建密钥。
3. 复制连接信息或导入 CCSwitch。
4. 在“用量”查看计费档位、输入、输出、缓存读取、缓存写入与实际扣除。

接口地址

Chat Completions

兼容常见的 messages 请求格式。流式请求可以传入 "stream": true；系统会请求使用量信息并在完成后结算。

curl https://www.sydxky.cn/ai-relay/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Responses API

面向支持 Responses 的模型，可使用 input 传入文本或结构化消息。

curl https://www.sydxky.cn/ai-relay/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "请给出一个简洁的实现方案"
  }'

Anthropic Messages

兼容 POST /v1/messages、x-api-key、系统提示词、图片内容块、工具调用和流式 SSE。Messages 请求会复用当前 API Key 的线路分组、模型白名单、余额、并发限制与统一用量结算。

curl https://www.sydxky.cn/ai-relay/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

Anthropic SDK 会自动追加 /v1/messages，因此 SDK、Claude Code 和按 Anthropic 格式工作的客户端应把 Base URL 填为 https://www.sydxky.cn/ai-relay，不要再手动追加 /v1。本站同时兼容已经保存为 /ai-relay/v1 的旧客户端配置。

模型列表

使用同一把 API Key 请求 GET /models，只返回该 Key 创建时所选线路分组中的可用模型。跨分组请求会被拒绝。不要把页面中的展示名称当作模型 ID，应使用返回数据中的 id。

curl https://www.sydxky.cn/ai-relay/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

SDK 配置

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.sydxky.cn/ai-relay/v1",
)

response = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://www.sydxky.cn/ai-relay/v1",
});

const result = await client.chat.completions.create({
  model: "gpt-5.6-terra",
  messages: [{ role: "user", content: "你好" }],
});

Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://www.sydxky.cn/ai-relay",
)

message = client.messages.create(
    model="gpt-5.6-luna",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(message.content[0].text)

Claude Code

Claude Code 原生使用 Anthropic Messages API，现可直接连接本站，无需再通过本地代理转换为 OpenAI Responses。请求仍使用当前 API Key 绑定的线路分组和真实模型 ID。

1. 下载与安装

Windows 推荐使用原生 PowerShell 安装器：

irm https://claude.ai/install.ps1 | iex

Windows 命令提示符也可以使用：

curl -fsSL https://claude.ai/install.cmd -o install.cmd
install.cmd
del install.cmd

macOS、Linux 或 WSL：

curl -fsSL https://claude.ai/install.sh | bash

也可以通过 npm 安装；按 Claude Code 当前官方要求，请先安装 Node.js 22 或更高版本：

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

claude --version
claude doctor

2. 直接连接本站

把模型 ID 换成当前 API Key 请求 GET /v1/models 返回的真实 ID：

$env:ANTHROPIC_BASE_URL = "https://www.sydxky.cn/ai-relay"
$env:ANTHROPIC_API_KEY = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "gpt-5.6-luna"

claude

export ANTHROPIC_BASE_URL="https://www.sydxky.cn/ai-relay"
export ANTHROPIC_API_KEY="YOUR_API_KEY"
export ANTHROPIC_MODEL="gpt-5.6-luna"

claude

也可以使用 ANTHROPIC_AUTH_TOKEN；本站同时支持标准 x-api-key 和 Authorization: Bearer。不要同时配置两把不同的密钥。

3. 可选：通过 CC Switch 管理

1. 先安装并启动 CC Switch，再打开本站 API Key 页面。
2. 在目标密钥右侧点击“导入 CCSwitch”，应用选择“Claude”，选择属于该密钥线路分组的主模型；需要时再选择 Haiku、Sonnet、Opus 角色模型。
3. CC Switch 弹出导入预览后确认导入，在 Claude 供应商列表中编辑刚导入的“AI STATION”。
4. 展开“高级选项”，把“API 格式”选择为“Anthropic Messages”，端点填写 https://www.sydxky.cn/ai-relay。
5. 启用 AI STATION 供应商；只有需要 CC Switch 热切换或本地路由时才需要开启应用接管。

claude
/status

直接连接时，/status 中的 Anthropic Base URL 应显示本站 https://www.sydxky.cn/ai-relay；使用应用接管时才会显示 CC Switch 的本地代理地址。发送一条简单消息后，可在本站“用量”页核对协议、模型、Token 与实际扣除。

4. 配置文件位置

• Windows：%USERPROFILE%\.claude\settings.json
• macOS / Linux：~/.claude/settings.json

开启 CC Switch 应用接管后，它会自动管理 ANTHROPIC_BASE_URL、认证与模型映射。接管期间不要再用不同值手动覆盖这些字段。Claude Code 支持 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、ANTHROPIC_MODEL 以及三档默认模型变量，本站 Messages 接口均可使用。

官方资料：Claude Code 安装、LLM Gateway 配置。

OpenAI Codex CLI

Codex CLI 原生支持 Responses API，可以直接连接本站，无需协议转换。模型必须使用当前 API Key 所属线路分组通过 GET /models 返回的真实 id，不要手动填写过期或不存在的名称。

1. 下载与安装

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

macOS 或 Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

也可以使用 npm 或 Homebrew：

npm install -g @openai/codex

# macOS
brew install --cask codex

codex --version
codex doctor
codex update

2. 推荐方式：从本站导入 CC Switch

1. 在 API Key 页点击“导入 CCSwitch”。
2. 应用选择“Codex”，再选择该密钥可用列表中的模型。
3. 在 CC Switch 导入预览中确认，随后启用“AI STATION”供应商。
4. 关闭并重新打开 Codex；如果已启用 CC Switch 的 Codex 本地路由，则供应商切换可以立即生效。

本站已经支持 Responses，Codex 直连时不需要打开“Chat Completions 本地路由映射”。CC Switch 本地代理仅在你需要本地用量日志、故障转移或热切换时选用。

3. 手动配置：环境变量

先创建仅属于你自己的环境变量。以下命令中的 YOUR_API_KEY 必须替换为本站生成的用户密钥，不要使用任何源站密钥。

$env:AISTATION_API_KEY = "YOUR_API_KEY"

[Environment]::SetEnvironmentVariable(
  "AISTATION_API_KEY",
  "YOUR_API_KEY",
  "User"
)

export AISTATION_API_KEY="YOUR_API_KEY"

持久保存后需要重新打开终端。共享电脑优先使用系统密钥管理工具或仅设置当前终端，不建议把真实密钥写入项目目录、脚本、截图或公共 Shell 配置。

4. 手动配置：config.toml

• Windows：%USERPROFILE%\.codex\config.toml
• macOS / Linux：~/.codex/config.toml

把 YOUR_MODEL_ID 换成当前密钥请求 GET /models 返回的模型 ID：

model_provider = "aistation"
model = "YOUR_MODEL_ID"

[model_providers.aistation]
name = "AI STATION"
base_url = "https://www.sydxky.cn/ai-relay/v1"
env_key = "AISTATION_API_KEY"
wire_api = "responses"
requires_openai_auth = false

此配置通过 env_key 读取密钥，不需要使用 ChatGPT 登录，也不要把密钥直接写进 config.toml。如果你的 Codex 版本不识别这些字段，请先执行 codex update。

5. 启动与验证

codex -m YOUR_MODEL_ID

codex exec -m YOUR_MODEL_ID "只回复：AI STATION 连接成功"

若项目目录尚未初始化 Git，非交互测试可追加 --skip-git-repo-check。验证完成后在本站“用量”页确认请求模型、Token 与扣费记录。

官方资料：Codex 文档、Codex 官方仓库。

CC Switch（CCSwitch）

CC Switch 是本机供应商管理工具，可管理 Claude Code、Codex、Gemini CLI 等客户端。本站使用官方 ccswitch://v1/import Provider 深度链接写入名称、公开 Base URL、你的用户密钥和真实模型 ID；导入前会显示预览并等待确认。

1. 下载与安装

唯一官方网站：ccswitch.io；安装包也可从 GitHub Releases 下载。系统要求为 Windows 10+、macOS 12+，或主流 Linux 发行版。

• Windows：下载 CC-Switch-vVERSION-Windows.msi 安装包，或下载 Windows-Portable.zip 解压后直接运行。
• macOS：推荐 Homebrew，也可以下载已签名和公证的 .dmg。
• Debian / Ubuntu：下载 .deb；Fedora / RHEL / openSUSE：下载 .rpm；其他 Linux 可使用 AppImage。

msiexec /i CC-Switch-vVERSION-Windows.msi

brew install --cask cc-switch
brew upgrade --cask cc-switch

sudo apt install ./CC-Switch-vVERSION-Linux.deb

sudo dnf install ./CC-Switch-vVERSION-Linux.rpm

sudo zypper install ./CC-Switch-vVERSION-Linux.rpm

chmod +x CC-Switch-vVERSION-Linux.AppImage
./CC-Switch-vVERSION-Linux.AppImage

# Arch Linux
paru -S cc-switch-bin

新版 CC Switch 还可在“设置/关于”中安装、升级和诊断受支持的 CLI 工具；若你的版本没有该入口，请使用上方各客户端的官方安装命令。

2. 本站一键导入

1. 启动 CC Switch，并在首次启动时允许它注册 ccswitch:// 协议。
2. 打开本站 API Key 页，在密钥右侧点击“导入 CCSwitch”。
3. 选择 Claude、Codex 或 Gemini，并选择当前密钥线路分组内显示的模型；Claude 还可分别设置 Haiku、Sonnet、Opus。
4. 浏览器询问是否打开 CC Switch 时选择允许，检查名称、端点、模型与密钥来源后确认导入。
5. 在 CC Switch 中启用新供应商。Codex 等非路由模式客户端通常需要重启；启用应用路由后可即时切换。

3. 手动添加供应商

1. 点击 CC Switch 主界面右上角“+”，选择“应用专属供应商”或“统一供应商”。
2. 名称填写 AI STATION，端点填写 https://www.sydxky.cn/ai-relay/v1，API Key 填写你的本站用户密钥。
3. 点击模型字段旁的“获取模型”；CC Switch 会请求本站 /v1/models，从返回列表选择模型，不要手工猜测名称。
4. Codex 选择 Responses 协议并使用 https://www.sydxky.cn/ai-relay/v1；Claude 选择 Anthropic Messages 并使用 https://www.sydxky.cn/ai-relay。
5. 保存并启用供应商，重新打开对应 CLI 后发送最小测试消息。

4. 深度链接没有反应

• 先确认 CC Switch 已经启动，再重新点击导入。
• Windows 重新安装 MSI，或检查系统是否存在 HKEY_CLASSES_ROOT\ccswitch 协议注册。
• macOS 可重新安装，或运行 /usr/bin/open -a "CC Switch" --args --register-protocol。
• Linux 检查桌面文件的 MimeType 是否注册了 CCSwitch 协议。
• 仍无法打开时，使用本站“复制连接”并按上方手动添加步骤填写。

官方资料：CC Switch 官方仓库、官方深度链接生成器。

客户端验证与常见问题

• Claude Code 请求成了 /v1/v1/messages：Base URL 末尾多写了 /v1。推荐改为 https://www.sydxky.cn/ai-relay；本站也保留了双 /v1 兼容路由。
• Anthropic 格式返回 401：确认使用的是本站用户密钥，并通过 x-api-key 或 Authorization: Bearer 发送；不要使用源站密钥。
• Codex 返回 /responses 404：检查 Base URL 是否完整为 https://www.sydxky.cn/ai-relay/v1，不要再手动追加 /responses 到 base_url。
• 提示 Model metadata not found：不要继续使用手工填写的旧模型名，例如不存在的 gpt-5-codex。重新请求 GET /models 或从本站重新导入 CC Switch，并完全重启客户端。
• 401：密钥错误、被停用或复制不完整。重新从 API Key 页复制，不要使用源站密钥。
• 402：余额不足，请先联系管理员充值。
• 403：所选模型不属于这把密钥的线路分组、模型白名单或 IP 规则。
• 429：触发密钥的速率、并发、日预算或月预算限制，稍后重试或在高级设置调整个人规则。
• CC Switch 切换后仍使用旧配置：关闭并重新打开 Codex/终端；路由模式下确认本地代理正在运行且对应应用接管已开启。
• 连接成功但本站没有用量：确认请求确实发往本站公开域名，并检查客户端是否被其他系统代理、旧环境变量或另一个供应商配置覆盖。

排错时只提交本站 X-Request-Id、HTTP 状态码、客户端名称和时间。请先遮盖 Authorization、API Key、完整配置文件与包含密钥的深度链接。

用量与计费

每次请求会先按高档价格保守预留额度，请求结束后释放预留，并根据真实输入 Token 是否达到 272K 选择最终档位。普通输入、输出、缓存读取、缓存写入分别结算。成功响应会附带以下本站响应头：

• X-Sydxky-Input-Tokens：输入 Token。
• X-Sydxky-Cache-Read-Tokens：缓存读取 Token。
• X-Sydxky-Cache-Write-Tokens：缓存写入 Token。
• X-Sydxky-Output-Tokens：输出 Token。
• X-Sydxky-Pricing-Tier：本次实际计费档位。
• X-Sydxky-Cost：本次实际扣除额度。
• X-Sydxky-Balance：请求完成后的钱包余额。
• X-Request-Id：本站请求编号，便于排查。

若模型没有返回 usage，系统会用保守估算值结算，并在用量记录中标注“估算”。

错误处理

Chat Completions 与 Responses 返回 OpenAI 风格错误；Anthropic Messages 返回 {"type":"error","error":{...}}。常见状态包括：401 密钥无效或停用、402 余额不足、403 IP/模型范围不允许、429 速率/并发/预算限制、503 模型线路暂时不可用。

所有公开错误都会经过安全处理，不会包含内部线路地址、内部密钥或原始线路诊断信息。