API 401 または 404 エラー: キー、ベース URL、モデル ID の間違い

リクエストがステータスコードで失敗し、まず何を触ればいいかわからないことがあります。短い答え: 401 は通常キーを指し、404 は通常間違った場所をノックしている — つまりアドレス（ベース URL とパス）かモデル ID のどちらかです。この順番で確認すべき 3 つのことと、修正を証明する 1 つの curl コマンドを紹介します。

OpenAI のエラーコードページ（2026 年 10 月 26 日確認）には、2 つの 401 メッセージが記載されています: 「Invalid Authentication」と「Incorrect API key provided」です。どちらも修正方法は同じで、キーを確認するか新しいキーを生成します。このページには API 自体の 404 は記載されていないため、404 については以下のルールは OpenAI 互換エンドポイントの動作に基づくもので、そのページからではありません。

素早く見分ける方法#

メッセージの文言はサーバーとツール（Cline、Aider、OpenCode、Continue はそれぞれ独自の方法でエラーをラップします）によって異なるため、番号から始めて、以下の curl チェックで確認してください。

401: キーがエンドポイントと一致しない#

よくある話: ツールを新しいプロバイダーに移し、ベース URL を変更したが、古いプロバイダーのキーを設定に残してしまった。アドレスは新しく、キーは古いままで、サーバーは 401 を返します。何も壊れていません。キーが別の家に属しているだけです。

確認すべきこと:

1. キーを発行したのはどのプロバイダーか？ 呼び出しているアドレスのプロバイダーでなければなりません。あるサービスのキーは別のサービスでは有効ではありません。
2. 余分な文字。 キーと一緒に貼り付けられたスペースや改行、値の中に入ってしまった引用符。
3. ツールがどこから読み取るか。 あるターミナルでは設定されているが、エディターが起動したターミナルでは設定されていない環境変数はよくある原因です。ツールに設定ファイルと環境変数の両方がある場合、どちらが優先されるかを確認してください。
4. 失効または削除されたキー。 削除または失効したキーは機能しなくなります — 新しいキーを作成して設定に入れてください。

キーの仕組みや保管場所がわからない場合は、API キーとは何か、安全に保管する方法で平易な言葉で説明しています。

すべてのモデルで 404: アドレスが間違っている#

CheapTokens のベース URL は https://api.cheaptokens.dev/v1 です。ツールと SDK はエンドポイントパスを自分で追加するため、よくあるミスは /v1 に関するものです:

• /v1 の欠落: ツールが https://api.cheaptokens.dev/chat/completions を呼び出してしまう。
• /v1 の重複: すでに追加されるフィールドに完全なパスを貼り付けて、https://api.cheaptokens.dev/v1/v1/chat/completions になる。
• 間違った種類: OpenAI スタイルのツールと OpenAI SDK は /v1 付きのアドレスを受け取ります。Anthropic SDK と Claude Code は /v1 なしのアドレスを受け取ります: https://api.cheaptokens.dev。

ベース URL とは正確に何か、そのどの部分をツールが追加するのか疑問に思ったことがあるなら、この解説で順を追って説明しています。Anthropic 側については、CheapTokens で Anthropic Python SDK を使うをご覧ください。

1 つのモデルで 404: モデル ID#

これは価格表や別のプロバイダーから名前をコピーした人が引っかかります。価格表には DeepSeek-V4-Flash と書かれているかもしれませんが、API は開発者プレフィックスとリリースを含む完全なゲートウェイ ID を要求します:

価格ラベルの短い ID は API では受け入れられず、綴りが重要です: 大文字、スラッシュ、-0731 サフィックス。同じモデルでもプロバイダーによって名前が異なるため、記憶から入力するのではなく CheapTokens のドキュメントから ID をコピーしてください。キーで利用可能な正確な ID を確認するには、同じ Authorization ヘッダーで GET https://api.cheaptokens.dev/v1/models を呼び出し、リストから ID をコピーします:

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

表の名前のロジックが奇妙に見える場合は、AI モデル名の読み方でエイリアスと固定バージョンの違いを説明しています。

1 つの curl コマンドで修正を証明する#

ツールを脇に置いて、API を直接呼び出します。キーのプレースホルダーを自分のものに置き換えてください:

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hi in one word."}],
    "max_tokens": 20
  }'

この 1 つのリクエストに 3 つの容疑者すべてが含まれています: ヘッダーのキー、最初の行のベース URL、ボディのモデル ID です。choices 配列を含む JSON 応答が返れば、3 つとも正しく、ツールが何か違うことをしているのが問題です。失敗した場合は、一度に 1 つだけ変更してください:

• 401 → CheapTokens から取得したキーに差し替えて再実行。
• 404 → URL を上記と 1 文字ずつ比較し、次にモデル ID を確認。

curl が機能したら、同じ 3 つの値をツールにコピーします: キー、ベース URL（https://api.cheaptokens.dev/v1、Anthropic SDK と Claude Code の場合は /v1 なし）、完全なモデル ID です。

それでもうまくいかない場合#

• ツールで同じエラー、curl は問題ない。 ツールが別の場所から古いキーや URL を読み取っています: 2 つ目の設定ファイル、保存されたプロファイル、環境変数など。変更後はツールを再起動してください。
• モデル ID が正しいかわからない。 キーで GET /v1/models を呼び出し、リストから ID をコピーしてください。
• 接続拒否、タイムアウト、証明書エラー。 これは 401 や 404 ではありません。一般的な接続エラーをご覧ください。
• 最初のリクエストがどうあるべきかわからない。 最初の API リクエストで順を追って説明しており、ドキュメントに完全なリファレンスがあります。

身につける価値のある習慣: 呼び出しが失敗したら、まず番号を読むこと。401 は通常キー、404 は通常アドレスかモデル ID を意味し、curl がそれを解決します。これで、ログを 1 つも開く前に、これらのエラーのほとんどを整理できます。