接入前，准备这三项

四步完成接入

1. 登录并确认可用额度

   打开控制台，查看余额或已生效的订阅；按实际需求选择充值或套餐。

2. 创建专用密钥

   进入 API 密钥，选择分组、填写名称并保存密钥。建议为不同应用分别创建。

3. 选择下方的接入教程

   把服务地址、密钥和模型名称填入客户端，或使用 API 示例接入自己的程序。

4. 发送一条简短消息

   收到回复后，到使用记录核对模型、用量和费用。模型测试请求会按实际用量计费。

选择你的使用方式

常用地址速查

创建 API Key

1. 登录控制台，打开 API 密钥 页面。
2. 点击创建密钥，填写便于识别的名称，例如「个人 Claude Code」或「项目开发环境」。
3. 选择对应分组，并按需设置有效期、额度或访问限制；以页面实际提供的选项为准。
4. 复制生成的完整密钥，保存在本机密码管理器或服务端环境变量中。

选择合适的分组

可选分组、开放模型和价格会随配置调整。以创建密钥页面、模型广场及当前密钥查询结果为准。教程中的模型名称是示例，并不代表所有密钥都有权限。

查询当前密钥可见的模型

设置环境变量后，通过模型列表接口检查鉴权和可见模型；该请求不生成模型回答。

export XUDIAN_API_KEY="YOUR_API_KEY"
curl --fail-with-body https://api.xudiansuanli.com/v1/models \
  -H "Authorization: Bearer $XUDIAN_API_KEY"

$env:XUDIAN_API_KEY = "YOUR_API_KEY"
Invoke-RestMethod -Uri "https://api.xudiansuanli.com/v1/models" -Headers @{
  Authorization = "Bearer $env:XUDIAN_API_KEY"
}

保存与更换密钥

不要把密钥写进网页前端、截图、公开仓库或发给他人。怀疑泄露时，在控制台停用旧密钥并创建新密钥，再更新对应应用。

YOUR_API_KEY 是占位符，请替换为本站生成的密钥；它不是登录密码，也不是上游官方账户的密钥。

Base URL 怎么填

https://api.xudiansuanli.com/v1

https://api.xudiansuanli.com

常用接口路径

网关提供以上入口，具体模型能力取决于密钥分组和对应模型。图片、音频、工具调用等功能需单独确认，不能仅凭接口名称判断支持范围。

鉴权方式

OpenAI 兼容请求使用 Authorization: Bearer YOUR_API_KEY。Claude Code 的 ANTHROPIC_AUTH_TOKEN 同样发送 Bearer 凭据；Anthropic SDK 也可使用 x-api-key。

这些地址容易填错

• 不要使用控制台网页地址，例如 /dashboard 或 /home。
• 不要把完整的 /v1/chat/completions 填到 SDK 的 Base URL 中。
• 出现 /v1/v1/... 时，检查客户端是否自动添加了 /v1。
• 不要把价格接口 /api/provider/pricing 当作模型调用地址。

安装与准备

按 Claude Code 官方安装说明 ↗ 安装，然后运行 claude --version 确认命令可用。准备一把绑定 Claude 分组的本站密钥。

在终端设置并启动

把占位符替换为自己的密钥，在同一个终端启动 Claude Code。以下变量只对当前终端及从它启动的程序生效。

export ANTHROPIC_BASE_URL="https://api.xudiansuanli.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
claude

$env:ANTHROPIC_BASE_URL = "https://api.xudiansuanli.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-6"
claude

保存到用户配置

需要长期使用时，将以下字段合并进用户配置 ~/.claude/settings.json。Windows 对应 %USERPROFILE%\.claude\settings.json。保留已有配置，不要整份覆盖。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xudiansuanli.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

VS Code 扩展

打开 VS Code 的用户设置 JSON，把以下字段合并进去，再重新启动扩展。仅在终端设置变量，不一定能影响从桌面打开的 VS Code。

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.xudiansuanli.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "YOUR_API_KEY" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-4-6" }
  ]
}

确认连接成功

在 Claude Code 中运行 /status，检查 Base URL 和凭据来源，再发送一条简短消息。若提示模型不可用，按当前分组实际开放模型修改名称。Claude 桌面客户端的配置方式不同，不直接套用此处的 CLI 配置。

配置参考：Claude Code 官方网关接入文档 ↗

安装与准备

按 Codex 官方安装说明 ↗ 安装 CLI，并确认 codex --version 可用。选择 GPT 分组密钥，例如「满血企业线路」。

配置自定义服务商

编辑用户级 ~/.codex/config.toml；Windows 对应 %USERPROFILE%\.codex\config.toml。将下面字段合并进已有文件，避免重复声明同名配置节。服务商设置应放在用户配置中。

model = "gpt-6.1-sol"
model_provider = "xudian"

[model_providers.xudian]
name = "序点算力"
base_url = "https://api.xudiansuanli.com/v1"
env_key = "XUDIAN_API_KEY"
wire_api = "responses"

设置密钥并启动

export XUDIAN_API_KEY="YOUR_API_KEY"
codex

$env:XUDIAN_API_KEY = "YOUR_API_KEY"
codex

env_key 填的是环境变量的名称，不是密钥本身。以上命令只对当前终端生效；之后从其他终端启动时，也需要让该进程能读取 XUDIAN_API_KEY。

检查当前配置

进入 Codex 后用 /status 查看当前模型与服务商，确认使用 xudian。发送一条简短消息，再到本站使用记录核对。若账户没有示例模型权限，将 model 替换为该分组支持的模型 ID。

配置参考：OpenAI 官方自定义服务商文档 ↗

添加自定义服务商

打开客户端的模型服务或服务商设置，新建一个连接。界面名称因软件版本而异，关键是选择正确的接口协议。

获取或手动添加模型

如果软件支持获取模型列表，先尝试获取；如果没有列出目标模型，在确认分组支持后手动填写完整模型 ID。不要只填「GPT」或「Claude」这样的展示名称。

检查最终请求地址

部分客户端会自动补上 /v1。若出现 404，检查实际请求地址应为 /v1/chat/completions、/v1/responses 或 /v1/messages，不要出现重复前缀。

按实际能力开启功能

先用纯文本对话验证，再逐项尝试流式输出、附件或工具调用。模型与客户端双方都支持某项能力时才启用，避免把格式或能力不兼容误判为密钥失效。

准备环境变量

先按 密钥检查示例 设置 XUDIAN_API_KEY。下面示例使用 GPT 分组和 gpt-6.1-sol，可替换为你的分组支持的模型。

Chat Completions 示例

curl --fail-with-body https://api.xudiansuanli.com/v1/chat/completions \
  -H "Authorization: Bearer $XUDIAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["XUDIAN_API_KEY"],
    base_url="https://api.xudiansuanli.com/v1",
    timeout=60.0,
    max_retries=0,
)
result = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "只回复 OK"}],
)
print(result.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XUDIAN_API_KEY,
  baseURL: "https://api.xudiansuanli.com/v1",
  timeout: 60_000,
  maxRetries: 0,
});
const result = await client.chat.completions.create({
  model: "gpt-6.1-sol",
  messages: [{ role: "user", content: "只回复 OK" }],
});
console.log(result.choices[0].message.content);

Responses 示例

Codex 使用此协议；其他应用也可按需要选择。下面在已创建的 Python client 上执行：

result = client.responses.create(
    model="gpt-6.1-sol",
    input="只回复 OK",
    store=False,
)
print(result.output_text)

流式输出

在请求体中设置 stream: true，并按对应协议消费 SSE 事件。Chat Completions 与 Responses 的事件结构不同，不要混用解析代码。

stream = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="", flush=True)

应用上线前

为请求设置超时和取消机制；记录状态码、模型与请求 ID；根据错误类型决定是否重试。示例关闭了 SDK 自动重试，方便第一次排查；生产环境按业务设置有限重试，避免重复提交和额外费用。

密钥保存在服务端。浏览器、小程序等前端应请求你自己的后端，由后端调用模型接口。

Messages 请求示例

准备 Claude 分组密钥，并设置 XUDIAN_API_KEY 环境变量。请求中包含 anthropic-version、模型、消息和输出 token 上限。

curl --fail-with-body https://api.xudiansuanli.com/v1/messages \
  -H "x-api-key: $XUDIAN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "只回复 OK"}]
  }'

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["XUDIAN_API_KEY"],
    base_url="https://api.xudiansuanli.com",
    timeout=60.0,
    max_retries=0,
)
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=128,
    messages=[{"role": "user", "content": "只回复 OK"}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

读取响应

文本通常位于响应的 content 数组中。遍历内容块时按 type 判断，不要假设所有块都是文本；工具调用、思考内容等可能使用不同块类型。

缓存与模型能力

提示词缓存、工具调用、长上下文和思考参数需符合对应模型与分组的实际支持情况。缓存读取、写入及不同有效期可能分别计价，使用前核对模型广场和账单。

查看价格

打开模型广场，按分组查看模型价格。相同模型在不同分组可能使用不同倍率或覆盖价；公开报价不代表个人专属优惠或订阅权益。

输入、输出、缓存读写可能分别计费。长上下文、特定服务层和附加工具还可能有独立规则，具体以站内配置与实际账单为准。

核对使用记录

1. 在客户端完成一次简短请求。
2. 打开使用记录，按时间、模型或密钥定位对应记录。
3. 核对模型名称、输入输出量、缓存用量与费用，判断是否使用了预期线路。

设置适合自己的限制

按控制台实际提供的选项设置密钥额度、有效期或访问限制。开发与生产使用不同密钥，有助于定位用量来源，也便于单独停用某个应用。

余额与订阅

余额不足或订阅到期可能导致请求被拒绝。请以控制台的余额、订阅状态、充值金额和订单结果为准；付款后不要连续重复提交订单，先核对订单状态，必要时联系客服。

按状态码排查

填了密钥，工具仍要求登录

确认工具进程实际读取到了环境变量。关闭旧进程后，从设置变量的同一终端启动；VS Code 扩展按专门的设置章节配置。检查是否有项目设置、用户设置或另一套凭据覆盖当前值。

模型存在，但当前密钥不能调用

核对密钥绑定的分组、模型完整名称和有效状态。通过 GET /v1/models 查看当前密钥可见的模型；模型广场的展示范围可能与某把密钥不同。

流式响应中断或长时间无输出

检查客户端、代理和网络的超时设置，确认使用对应协议的 SSE 解析方式。发生中断后先核对使用记录，再决定是否重试；已产生的模型用量可能已经计费。

需要人工协助

打开 QQ / 微信客服 ↗，提供发生时间、客户端版本、模型名称、分组、状态码和请求 ID。如果有错误截图，请遮住完整 API Key、密码和个人敏感信息。