文档
快速开始
Synapsea 兼容 OpenAI 与 Anthropic 官方 SDK 的请求格式。把 base_url 指过来、换上你的 Key, 其余代码保持原样。
1. 创建 API Key
注册并完成邮箱验证后, 在控制台创建 Key。创建时可以单独设置额度上限与有效期, 建议按项目分别创建, 方便追踪消耗和单独停用。
2. 配置访问地址
所有请求发往同一个地址, 两种协议共用一个账户余额。
Base URL https://app.claudelike.online
OpenAI 协议 https://app.claudelike.online/v1
鉴权头 Authorization: Bearer <你的 Key>3. 发起第一次请求
curl
curl https://app.claudelike.online/v1/chat/completions \
-H "Authorization: Bearer $SYNAPSEA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "你好"}]
}'Python（OpenAI SDK）
from openai import OpenAI
client = OpenAI(
base_url="https://app.claudelike.online/v1",
api_key="sk-****",
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)Node（OpenAI SDK）
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://app.claudelike.online/v1",
apiKey: process.env.SYNAPSEA_API_KEY,
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);4. 在 Claude Code 等客户端中使用
凡是允许自定义 base_url 的客户端都可以接入, 包括 Claude Code、Codex、Cline、Cursor 等。以 Claude Code 为例:
export ANTHROPIC_BASE_URL=https://app.claudelike.online
export ANTHROPIC_AUTH_TOKEN=sk-****
claude其它客户端在设置里找到 Base URL / API 地址一项, 填入上方地址即可, 无需改动其余配置。
错误码
返回体为标准 JSON, 出错时 message 字段说明原因。
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 401 | Key 无效、已删除或已禁用 | 在控制台确认 Key 状态，必要时重新创建 |
| 402 | 账户余额不足 | 充值后立即恢复，无需重建 Key |
| 403 | 该 Key 无权访问所请求的模型 | 创建 Key 时选择包含该模型的通道 |
| 404 | 模型名写错或未开通 | 核对模型名，见下方模型列表 |
| 429 | 请求过于频繁 | 退避重试，或联系我们调整上限 |
| 5xx | 服务暂时不可用 | 建议实现指数退避重试 |
使用建议
- 为不同环境创建独立 Key 并分别设置额度上限, 便于隔离与追踪。
- 对 5xx 与 429 实现指数退避重试, 首次退避建议 1 秒起。
- 流式输出请按 SSE 逐块读取, 与官方 SDK 行为一致。
- Key 一旦泄露, 在控制台立即删除并重新创建, 其余 Key 不受影响。
还有问题?
接入过程中遇到任何问题, 发邮件给我们, 通常一个工作日内回复。