Anthropic SDK で Claude に接続したところ、リクエストを送った途端に 404 が返り、APIキーを変えてもネットワークを確認しても改善しない——そんなときに最初に確認すべきは、ベースURLの末尾に /v1 が余分に付いていないかどうかです。/v1 を余分に書くと、/v1/v1/messages に組み合わされます。これは APIYI に接続する際に陥りやすい、典型的な落とし穴のひとつです。
これは API が不安定なわけでも、APIキーが無効なわけでもありません。APIYI の開発者ドキュメントでは2つのアドレスが明確に区別されています。Anthropic SDK のベースURLには https://api.apiyi.com、OpenAI SDK のベースURLには https://api.apiyi.com/v1 を設定します。アドレスは SDK で選ぶものであり、モデルで選ぶものではありません。
この記事のポイント：Claude のエンドポイントに何を設定すべきかを3分で把握し、この種の404もまとめて解消できます。
要点早見表：Claude のエンドポイントにはどれを設定するか
結論から言うと、Anthropic SDK で Claude を呼び出す場合、ベースURLはルートドメインの https://api.apiyi.com とし、末尾に /v1 を付けません。付けてしまうと、SDK が自身のパスを自動で追加し、最終的なリクエストは /v1/v1/messages に送られます。サーバー側にこのアドレスは存在しないため、404 が返ります。
| 項目 | 内容 |
|---|---|
| エラー症状 | リクエストが 404 を返し、実際のパスに /v1/v1/messages が現れる |
| 直接の原因 | Anthropic SDK のベースURLに /v1 を余分に書いている |
| 正しいアドレス（Anthropic SDK） | https://api.apiyi.com |
| 正しいアドレス（OpenAI SDK） | https://api.apiyi.com/v1 |
| アドレス選択の原則 | アドレスは SDK で選び、モデルでは選ばない |
| 公式の出典 | APIYI 開発者ドキュメント（apiyi.com） |
2つのアドレスはそれぞれ異なるAPI形式に対応しており、ルールに互換性はありません。以下では原因と比較を詳しく説明します。
Claude のエンドポイントに /v1 を余分に書くと 404 になる理由
/v1/v1/messages はどうやって組み立てられるのか
Anthropic SDK はリクエストを送るとき、base URL の後ろに自動で /v1/messages を付加します。パスの先頭にある /v1 は、もともと SDK が担当する部分です。ここで base URL にさらに /v1 を手書きすると、二重に付加されてしまいます。base URL に https://api.apiyi.com/v1 を設定すると最終的なリクエストは /v1/v1/messages になり、https://api.apiyi.com を設定すれば正常な /v1/messages になります。
この種の 404 が紛らわしいのは、「見つからない」ということだけを伝え、「なぜ見つからないのか」は教えてくれない点です。ログやエラー詳細に /v1/v1/messages のようなパスが出ていれば、ほぼ base URL を余分に一層書いたことが原因だと特定できます。調べ方も簡単で、実際のリクエストパスを正しいアドレスと照らし合わせれば、重複した /v1 はすぐに見つかります。
Claude のエンドポイント対応表：モデルではなく SDK で選ぶ
APIYI は Anthropic ネイティブインターフェースと OpenAI 互換インターフェースを同時に提供しており、2つの入口アドレスは異なります。Google GenAI SDK もルートドメインを使いますが、追加でバージョンパラメータを設定する必要があります。3つの正しい設定は以下のとおりです：
| SDK | base URL | 追加設定 | 備考 |
|---|---|---|---|
| Anthropic SDK | https://api.apiyi.com |
なし | /v1 を余分に書くと /v1/v1/messages になり、404 が返る |
| OpenAI SDK | https://api.apiyi.com/v1 |
なし | /v1 が足りない場合も同様に 404 が返る |
| Google GenAI SDK | https://api.apiyi.com |
api_version に v1beta を設定 |
Anthropic SDK と同じルートドメインを使う |
OpenAI 互換インターフェースに /v1 が必須な理由
ここが最も間違えやすい点です。すべてのインターフェースで /v1 を付けないわけではありません。OpenAI 互換インターフェースの入口はもともと /v1 という階層で定義されているため、この部分は base URL で補う必要があります。そのため OpenAI SDK で APIYI に接続する場合、base URL は https://api.apiyi.com/v1 でなければならず、これが欠けても同様に 404 になります。
逆に Anthropic SDK に切り替えるときは /v1 を外します。一言で覚えるなら「OpenAI SDK は /v1 付き、Anthropic SDK は /v1 なし」です。判断基準は常にコードで import している SDK であり、呼び出したいモデルではありません。アドレスは SDK に従うもので、モデルとは無関係です。
比較のポイント：2つのアドレスのルールは APIYI apiyi.com の公式ドキュメントを基準にしています。接続前に上表と照らし合わせて確認すれば、404 の調査時間を大幅に減らせます。
影響分析：Claude のエンドポイントURLを間違えると何が滞るか
Claude エンドポイントURLの誤りが開発・デバッグに与える影響
- 原因の誤認：404 が出ると、まずAPIキーや利用枠、ネットワークを疑ってしまい、一連の調査がすべて見当違いの方向に進みます。
- 気づくのが遅い：URLの誤りはクライアント作成時にはエラーになりません。リクエストが実際に送信された時点で初めて露呈します。
- 修正はすぐ終わる：実際のリクエストパスと正しいURLを突き合わせれば、重複した
/v1は一目で分かり、修正後すぐに復旧します。
Claude エンドポイントURLのルールがチーム導入に与える影響
- ルールを統一する：チーム内にOpenAIのルールを覚えている人とAnthropicのルールを覚えている人が混在していると、同じ404が繰り返し発生します。
- 設定を固定化する：base URLと環境変数を共通の接続手順書に書き込み、新規メンバーがそのままコピーすれば済むようにします。記憶に頼ってアドレスを入力する必要はありません。
- APIキーは環境変数で管理：APIキーは環境変数
APIYI_API_KEYで管理し、ハードコーディングを避けます。
Claude エンドポイントURLのトラブルシューティング対照表
| 使用するSDK | 入力するアドレス | 実際の結果 | 修正方法 |
|---|---|---|---|
| Anthropic SDK | https://api.apiyi.com/v1 |
404、パスは /v1/v1/messages |
末尾の /v1 を削除 |
| Anthropic SDK | https://api.apiyi.com |
正常に返答 | そのまま維持 |
| OpenAI SDK | https://api.apiyi.com |
404 | /v1 を追加 |
| OpenAI SDK | https://api.apiyi.com/v1 |
正常に返答 | そのまま維持 |
推奨：APIYI apiyi.com で登録すると、新規ユーザー向けの無料テスト枠を受け取れます。上の表の正しいアドレスで一度リクエストを実行すれば、404が
/v1に起因するかどうかを数分で確認できます。
Claude インターフェースアドレスに関するよくある質問 FAQ
Q1：Claude のインターフェースアドレスに余計な /v1 を付けてしまうのはどういうことですか？
Anthropic SDK の base URL に `https://api.apiyi.com/v1` を設定してしまった状態を指します。SDK は base URL の後ろに自動で `/v1/messages` を追加するため、実際のリクエストは `/v1/v1/messages` になり、サーバーから 404 が返されます。正しい設定はルートドメイン `https://api.apiyi.com` のみを指定することです。
Q2：Claude のインターフェースアドレスと OpenAI 互換アドレスはどう違うのですか？
エンドポイントが2つあり、それぞれ異なります。Anthropic SDK では `https://api.apiyi.com` を使い、末尾に `/v1` は付けません。OpenAI SDK では `https://api.apiyi.com/v1` を使い、`/v1` が必須です。この違いは SDK によって決まるもので、どのモデルを呼び出すかとは関係ありません。2つのルールを入れ替えて使うことはできません。
Q3：このアドレスルールはどのバージョンを基準にしていますか？
本記事は 2026 年 11 月 13 日に確認したルールに基づいて執筆しています。Anthropic SDK はルートドメイン、OpenAI SDK は `/v1` 付き、Google GenAI SDK はルートドメインで `api_version` を `v1beta` に設定します。接続前には docs.apiyi.com の開発者ドキュメントで最新の取り決めをもう一度確認することをおすすめします。
Q4：404 が /v1 の重複指定によるものだと、素早く確認するにはどうすればいいですか？
リクエストの実際のパスを見てください。`/v1/v1/messages` が現れていれば、base URL に `/v1` が余分に付いている証拠です。アドレスを `https://api.apiyi.com` に変更して再試行すれば解決します。本記事のトラブルシューティング対照表を使い、項目ごとに確認する方法もあります。
Q5：Key はどう設定すればいいですか？アドレスを直してもまだ 404 になる場合は？
Key は環境変数 `APIYI_API_KEY` で管理します。APIYI apiyi.com のコンソールで作成したものを環境変数に書き込めばよく、コードにハードコードしないでください。アドレスと Key の両方に問題がないのに 404 が返る場合は、トラブルシューティング対照表に戻って2つのアドレスを取り違えていないか確認するか、APIYI のウェブサイトトップページからサポートに問い合わせてください。
Claude APIエンドポイントの重要ポイント
- 一言結論：Anthropic SDK の base URL には
https://api.apiyi.comを設定し、末尾に/v1は付けません。 - エラーの仕組み：余分に
/v1を書くと/v1/v1/messagesに組み合わされ、リクエストはそのまま 404 になります。 - 逆のルール：OpenAI SDK では必ず
https://api.apiyi.com/v1を使い、/v1を省いても同じく 404 になります。 - 選び方の原則：アドレスは SDK で選び、モデルで選ばない。どの SDK を import しているかで決まります。
- 第三の選択肢：Google GenAI SDK もルートドメインを使い、
api_versionをv1betaに設定します。 - Key の管理：環境変数
APIYI_API_KEYを使い、Key は APIYI apiyi.com のコンソールで作成します。
まとめ：Claude の API エンドポイントはこれ一つで覚えられる
- 原因は明確：Anthropic SDK の base URL に
/v1を余分に書くと、リクエストが/v1/v1/messagesに組み合わされ、404 が返ってきます。 - ルールは対になる：Anthropic SDK は
https://api.apiyi.com、OpenAI SDK はhttps://api.apiyi.com/v1。SDK で選び、モデルで選びません。 - 切り分けは簡単：実際のリクエストパスを見比べれば、重複した
/v1は一目で分かります。アドレスを直せばすぐに復旧します。
アドレスの問題は決して難しくありません。難しいのは、それを最初に思い出すことです。接続やトラブルシューティングの際は、APIYI apiyi.com の公式ドキュメントと照らし合わせて素早く検証することをおすすめします。新規アカウントには無料のテスト枠が付いており、数行の設定で方向性を確認できます。
📚 参考資料
- APIYI 開発者キットのドキュメント：各 SDK の base URL とパラメータ設定に関する信頼できる情報源
- リンク：
docs.apiyi.com/developer-kit.md -
説明：接続前に一通り目を通し、アドレスとパラメータの取り決めを確認することをおすすめします
-
APIYI 技術仕様インデックス：プラットフォームインターフェースとモデル仕様の索引
- リンク：
docs.apiyi.com/llms.txt - 説明：インターフェースの取り決めをすばやく確認できるように、開発者キットのドキュメントと併用してください
著者：APIYI技術チーム
技術交流：APIYI のウェブサイトトップページからお問い合わせください。さらに資料が必要な場合は、docs.apiyi.com のドキュメントセンターをご覧ください
