API COMPATIBILITY
Base URL、路径与鉴权
先把协议和客户端对齐，再填地址。最容易出错的是把 Anthropic 的根路径写成 /v1，或把 OpenAI 兼容的 /v1 漏掉。 本页最后更新：2026-11-08。
| 协议 / 客户端 | Base URL | 鉴权 | 示例路径 | 说明 |
|---|---|---|---|---|
| Anthropic SDK / Claude Code | https://openox.tech | x-api-key 或 ANTHROPIC_AUTH_TOKEN（Authorization: Bearer） | /v1/messages | Base URL 用根路径，不要加 /v1；SDK 会自行拼接 /v1/messages。 |
| OpenAI SDK / OpenAI 兼容客户端 | https://openox.tech/v1 | Authorization: Bearer | /chat/completions、/responses、/models | Base URL 带 /v1；客户端会自行拼接 /chat/completions 等路径。 |
| Codex CLI | https://openox.tech/v1 | OPENAI_API_KEY | /responses（由客户端拼接） | openai_base_url 使用 /v1；若客户端版本自行拼接 /v1，请按实际请求路径复核。 |
| CC Switch（Claude Code 配置） | https://openox.tech | ANTHROPIC_AUTH_TOKEN | /v1/messages | CC Switch 走 Anthropic 协议，Base URL 用根路径，不要写 /v1。 |
| 图片生成 | https://openox.tech/v1 | Authorization: Bearer | /images/generations | 模型使用 gpt-image-2 / gpt-image-2-4k 等，具体参数以模型广场为准。 |
Anthropic / Claude Code
export ANTHROPIC_BASE_URL="https://openox.tech"
export ANTHROPIC_AUTH_TOKEN="sk-your-key"不要写成 https://openox.tech/v1；SDK 会自行拼接 /v1/messages。
OpenAI 兼容
export OPENAI_BASE_URL="https://openox.tech/v1"
export OPENAI_API_KEY="sk-your-key"客户端会拼接 /chat/completions、/responses 或 /models。
常见错误
404
Base URL 多写/少写 /v1，或协议与路径不匹配。
401
API Key 缺失、不完整，或没有放在正确的鉴权头。
400
模型 ID、请求体或参数与客户端协议不一致。
常见问题
为什么 Anthropic 用根路径，OpenAI 用 /v1？
Anthropic SDK 会在 Base URL 后自行拼接 /v1/messages，所以 Base URL 只写到域名根；OpenAI 兼容客户端通常把 Base URL 当作 /v1 前缀，再拼接 /chat/completions 或 /responses。写反会得到 404。
出现 404 应该先检查什么？
先检查 Base URL 是否多写或少写 /v1，再确认请求路径是否与客户端协议匹配。Anthropic 应请求 /v1/messages，OpenAI 兼容应请求 /v1/chat/completions 或 /v1/responses。
出现 401 应该先检查什么？
检查 API Key 是否完整、是否放在正确的请求头中。OpenAI 兼容使用 Authorization: Bearer；Anthropic 兼容使用 x-api-key 或 ANTHROPIC_AUTH_TOKEN。
这些地址会变吗？
本页是当前工程核验口径，最后更新 2026-11-08。客户端版本差异可能导致路径拼接不同；以实际请求日志和模型广场/控制台的最新说明为准。
相关页面：模型广场 · 价格与计费 · Claude Code 教程