Base URL 和鉴权
选择正确的兼容协议、Base URL 和请求头。
Sublyx 提供 OpenAI compatible 与 Anthropic Messages 两类入口。二者共享同一套 Sublyx API Key，但 Base URL 的 /v1 位置不同。
Base URL
| 协议 | Base URL | 常见客户端 |
|---|---|---|
| OpenAI compatible | https://api.sublyx.org/v1 | OpenAI SDK、Codex、Cherry Studio |
| Anthropic Messages | https://api.sublyx.org | Claude Code、Anthropic SDK |
最常见的配置错误
OpenAI compatible 的 Base URL 末尾带 /v1；Anthropic Messages 的 Base URL 不带 /v1，客户端会自行请求 /v1/messages。
Bearer 鉴权
推荐通过 Authorization 请求头发送 Key：
Authorization: Bearer sk-sublyx-example完整请求示例：
curl https://api.sublyx.org/v1/models \
-H "Authorization: Bearer sk-sublyx-example"Anthropic 请求头
使用 Anthropic Messages 格式时，也可以按客户端要求发送 x-api-key：
curl https://api.sublyx.org/v1/messages \
-H "x-api-key: sk-sublyx-example" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 512,
"messages": [
{"role": "user", "content": "你好"}
]
}'请求约定
- JSON 请求应包含
Content-Type: application/json。 - 使用 UTF-8 编码提交中文内容。
- 不要在查询字符串中传递 API Key。
- 生产环境应设置合理的连接、读取和总请求超时。
- 对
429、500、502、503和504使用带抖动的指数退避。