接入文档
本网关同时兼容 OpenAI 与 Anthropic 两套协议,绝大多数客户端只需改 Base URL 与密钥。
基本信息
| OpenAI 兼容 Base URL | — |
| Anthropic 兼容 Base URL | — |
| 鉴权方式 | Authorization: Bearer sk-xxx / x-api-key: sk-xxx |
| 对话端点 | /v1/chat/completions / /v1/messages |
| 模型列表端点 | /v1/models |
| 流式输出 | stream: true(SSE) |
签发密钥
打开 控制台 → 左侧「令牌」→「添加令牌」,得到 sk- 开头的密钥。
建议:按用途分别创建(例如
claude-code、cherry-studio、ci),单个泄露时只吊销那一个。Claude Code
Claude Code 走 Anthropic 协议,把 Base URL 指过来并指定模型即可。
# macOS / Linux:写入 shell 配置
export ANTHROPIC_BASE_URL="https://__HOST__"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="deepseek-flash"
claude
或者写进 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://__HOST__",
"ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
"ANTHROPIC_MODEL": "deepseek-flash"
}
}
Windows:在 PowerShell 里用
$env:ANTHROPIC_BASE_URL="https://__HOST__" 设置,或用「系统属性 → 环境变量」写入用户变量。Codex / Codex CLI
Codex 走 OpenAI 协议,配置 ~/.codex/config.toml:
model_provider = "lyapi" model = "deepseek-flash" [model_providers.lyapi] name = "LY API" base_url = "https://__HOST__" wire_api = "chat"
注意:本网关对外提供的是
chat 协议,wire_api 请填 chat,不要填 responses。OpenAI SDK
# Python
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://__HOST__/v1",
)
r = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)
// Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "https://__HOST__/v1",
});
const r = await client.chat.completions.create({
model: "deepseek-flash",
messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);
curl
# OpenAI 协议 curl https://__HOST__/v1/chat/completions \ -H "Authorization: Bearer sk-你的密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-flash", "messages": [{"role":"user","content":"你好"}], "stream": false }' # Anthropic 协议 curl https://__HOST__/v1/messages \ -H "x-api-key: sk-你的密钥" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-flash", "max_tokens": 512, "messages": [{"role":"user","content":"你好"}] }'
第三方客户端
任何支持自定义 Base URL 的客户端都能接入,填法一致:
| Cherry Studio / LobeChat / ChatBox | API 地址填 https://__HOST__ ,密钥填 sk-xxx,模型手动添加 |
| Cursor / Continue / Cline | 选 OpenAI Compatible,Base URL 填 https://__HOST__/v1 |
| 沉浸式翻译 / Zotero 插件 | 选自定义 OpenAI,Base URL 同上 |
模型列表
实时从网关读取:
curl https://__HOST__/v1/models \ -H "Authorization: Bearer sk-你的密钥"
可用模型与价格见 模型广场。
错误码
| 401 无效令牌 | 密钥错误或已被吊销,去控制台核对 |
| 403 无权限 | 该令牌未开通对应分组/模型 |
| 429 限流 | 超出该令牌的速率或额度限制 |
| 400 参数错误 | 模型名不在可用列表,或请求体格式不对 |
| 5xx 上游异常 | 上游供应商故障,稍后重试 |
计费说明
按 token 计费:输入与输出分别计价,缓存命中的 token 按缓存价单独计算。控制台「日志」中每条请求都有 token 数与扣费明细,可用于对账。
提醒:请求内容属于你的数据,请勿在提示词中放入密钥、密码、身份证号等敏感信息。