基础 URL
最容易让人出错的设置：各客户端需要哪个 URL，以及是否应包含 /v1 后缀。
几乎所有集成失败都是基础 URL 配置错误所致。本页明确说明应如何设置，可作为参考。
规则
| 客户端 | 将基础 URL 设置为 | 随后调用 |
|---|---|---|
| Anthropic SDK（Python / TS） | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| Claude Code | https://aiprimetech.io | https://aiprimetech.io/v1/messages |
| OpenAI SDK（Python / TS） | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
| LangChain / LiteLLM / Cursor | https://aiprimetech.io/v1 | https://aiprimetech.io/v1/chat/completions |
Anthropic 客户端：不包含
/v1。OpenAI 客户端：包含 /v1. Anthropic SDK 会追加 /v1/messages 到你提供的任何基础 URL 后；OpenAI SDK 则仅追加 /chat/completions。将 /v1 添加到 Anthropic 基础 URL 后，会使请求发往 /v1/v1/messages，从而返回 404。如何判断配置错误
| 你看到 | 含义 |
|---|---|
404 ，且路径中包含 /v1/v1/ | 你添加了 /v1 到 Anthropic 风格的基础 URL 后。请将其移除。 |
404 在 /chat/completions ，但不包含 /v1 | 你遗漏了 /v1 ，未将其包含在 OpenAI 风格的基础 URL 中。请将其添加。 |
404 在 /v1/chat/completions ，来自 Anthropic 工具 | 该工具使用 Messages，而非 Chat Completions。请使用 Anthropic 基础 URL 和端点。 |
| 连接正常，但每次调用都返回 401 | URL 正确，但认证请求头不符合该格式。请参阅 身份验证. |
不使用任何 SDK 进行验证
在将问题归咎于框架之前，这是确认 URL 和密钥正确的最快方式：
"c"># should return JSON with a "data" array of model ids
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"A 200 表示 URL 和密钥均正确，剩余问题都出在客户端配置中。