ベース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用ツールから返される | そのツールはChat CompletionsではなくMessagesを使用します。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とキーはどちらも正しく、残る問題はクライアントの設定にあります。