接入文档

本网关同时兼容 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 / ChatBoxAPI 地址填 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 数与扣费明细,可用于对账。

提醒:请求内容属于你的数据,请勿在提示词中放入密钥、密码、身份证号等敏感信息。