JA ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
API キーを取得

LLM API エラー 401:認証失敗の修正

LLM APIのエラー401は、サーバーがリクエストの認証を行えなかったことを意味します。ほぼすべての場合、原因はクライアント側にあります:ヘッダーのタイプミス、不要な文字が含まれたキー、または間違ったホストへのリクエストです。このガイドでは、問題を最も早く見つけるためのチェック手順を順を追って説明します。

更新

輝くロックに適合しないキー。LLM API 呼び出し時の認証失敗を示す

主要ポイント

  1. 401 はレート制限や課金エラーではなく、認証失敗です。
  2. ヘッダーは正確に Authorization: Bearer YOUR_KEY でなければなりません。スペースは 1 つ、引用符は不要です。
  3. 間違った Base URL に送信されたキーは、間違ったキーと同様に失敗します。
  4. まず curl でテストしてください。curl が動作すれば、バグはアプリの設定にあります。

まずこのcurlテストを実行してください

コードを変更する前に、アプリをテスト対象から外してください。この1つのコマンドで、APIに対して最小限の有効なリクエストを送信します。

curl -i https://api.unrestrictedaiapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

GET /v1/models は無料なので、キーをテストする安全な方法です。-i フラグはステータス行とヘッダーを出力します。

  • 200 とモデルリスト: キーは正常です。アプリは異なるものを送信しているため、環境変数と Base URL のセクションに進んでください。
  • 401: キーまたはヘッダーが間違っています。次のセクションに進んでください。
  • 接続または DNS エラー: Base URL が間違っています。これは 401 とは異なる問題です。

変数経由ではなく、このテストにAPI キーを手動で貼り付けてください。これで、環境が疑われるリストから除外されます。

原因 1:ヘッダーが正確ではない

API は Authorization: Bearer <key> を期待します。小さな逸脱もすべて LLM API エラー 401 を引き起こします:

  • Authorization: YOUR_KEY Bearer の単語が欠落している。
  • Authorization: Bearer: YOUR_KEYに余分なコロンがあります。
  • Authorization: Bearer "YOUR_KEY" 値内に引用符がある。
  • Authorization: Bearer YOUR_KEYにスペースが2つあります。
  • X-API-Key や api-key という名前のヘッダーを、Authorization の代わりに使用している。これらは他のサービスの慣習です。

OpenAI SDKを使用する場合、ヘッダーを手動で記述する必要はありません。SDKはapi_key引数からヘッダーを構築します。それでも401エラーが表示される場合、SDKに渡された値に問題があり、ヘッダーの形式には問題がありません。

原因 2:キー自体が破損している

キーは長いランダムな文字列であるため、コピーミスは一般的で目視では発見しにくいです。

  • 末尾の改行または空白。ターミナルやテキストファイルからコピーすると、末尾に改行や空白が追加されることがよくあります。多くのHTTPライブラリはその後、無効なヘッダーを送信するか、一致しないAPI キーを送信します。
  • 切り捨てられたキー。 キーに単語選択を妨げる文字が含まれている場合、ダブルクリックすると文字列の一部しか選択されません。代わりに API キーページ のコピーボタンを使用してください。
  • スマートクォート。 ワードプロセッサやチャットアプリを介して貼り付けると、直角の引用符が曲がりくねった引用符に置き換わることがあります。
  • 古いキーまたはローテーションされたキー。 新しいキーを作成した場合、古いキーは現在使用しているキーではない可能性があります。

Python で不可視文字を確認するには、値の repr を出力します:

import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))

2 行目に False が表示される場合、キーの周りに空白があります。読み込む際に .strip() を呼び出してください。

原因 3:間違った Base URL

既存のアプリを新しいプロバイダーに切り替える際の最も一般的なミスです。キーは、発行元のホストでのみ有効です。このサイトの Base URL は次の通りです:

{"base_url": "https://api.unrestrictedaiapi.com/v1"}

2つの失敗パターンが何度も現れます:

  • 新しいAPI キーを設定しましたが、古いBase URLを残したままにしています。リクエストは古いプロバイダーに送信され、そこではまだ見たことのないAPI キーが拒否され、401が返されます。エラーテキストには古いプロバイダーの名前が表示され、これは有用な手がかりになります。
  • 新しい Base URL を設定したが、環境変数に古いキーを残したままにしている。リクエストは当方に到達し、当方は他プロバイダーのキーを拒否する。

パスも確認してください。Base URL にはすでに /v1 が含まれているため、SDK は /chat/completions を追加します。URL を手動で構築する場合、完全なパスは /v1/chat/completions であり、/v1/v1/chat/completions ではありません。

原因 4:環境変数と設定ファイル

curl は動作するがアプリが失敗する場合、アプリに想定とは異なるキーが供給されている可能性があります。

  • 変数がエクスポートされていない。シェルではAPI_KEY=abc python app.pyは機能しますが、API_KEY=abcを単独の行に記述しても子プロセスに伝わりません。exportを使用してください。
  • 他の値によってシャドウされている。 ライブラリは OPENAI_API_KEY を自動的に読み込むことがある。シェルのプロファイルに古いものが設定されている場合、意図した値を上書きする可能性がある。
  • .envファイル内の引用符。一部のローダーは、引用符を値の一部として保持します。API キーが引用符で囲まれた状態で届く場合は、それらを取り除くか、上記のreprチェックでテストしてください。
  • 再起動されていない。サーバーやノートブックは起動時に環境変数を読み取ります。編集後は再起動してください。
  • プロダクション環境が異なる。 コンテナ、CI、ホスティングダッシュボードはそれぞれ独自の変数ストアを持つ。ログにはキー自体ではなく、キーの長さを出力せよ。

設定が正しいことを証明する最小限の Python チェック

このスクリプトは OpenAI SDK を使用し、認証失敗の場合に明確に報告します:

import os
from openai import OpenAI, AuthenticationError

client = OpenAI(
    base_url="https://api.unrestrictedaiapi.com/v1",
    api_key=os.environ["API_KEY"].strip(),
)

try:
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": "Reply with the word ok."}],
        max_tokens=5,
    )
    print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
    print("401:", e.status_code, e.response.headers.get("X-Request-Id"))

これが X-Request-Id を出力する場合、サポート に連絡する際に含めてください。これによりチームがリクエストを特定できます。他の言語での同じチェックは、5 つの言語のクイックスタート にあります。

401 とその他のエラー

エラーが認証以外のものの場合、認証に時間を費やさないでください。簡易マップ:

コード一般的な意味確認箇所
401キーの欠落または無効ヘッダー、キー、ベースURL
429レート制限または一時的な過負荷バックオフして再試行してください。制限についてはドキュメントをご覧ください
400リクエストボディの形式エラーJSON、モデル名、パラメータ
404間違ったパスベースURLとエンドポイント

モデル名も確認してください。uncensoredを正確に入力してください。間違ったモデルIDは401エラーではなくリクエストエラーとなります。APIが受け付けるエンドポイントやヘッダーを含む仕様詳細は、OpenAI互換API仕様ページに記載されています。

プロキシ、ブラウザ、最後の手段

2つのセットアップは、不審に見える401エラーを引き起こします。

プロキシとゲートウェイ

アプリとAPIの間に設置されたリバースプロキシ、APIゲートウェイ、またはサーバーレスラッパーが、Authorizationヘッダーを削除または書き換える場合があります。curlを使用して同じマシンからテストし、比較してください。一部のフレームワークではヘッダーが同じオリジンのホストにのみ転送されるため、カスタムフェッチラッパーを使用すると、クロスオリジンの呼び出しでヘッダーが静かに失われることがあります。

フロントエンドコード内のキー

ブラウザのJavaScriptから直接APIを呼び出すと、API キーは開発者ツールを開く誰でもアクセス可能な状態になり、ブラウザは認証エラーのように見える理由でクロスオリジンのリクエストをブロックすることもあります。API キーをサーバーに保持し、フロントエンドがAPIを呼び出すエンドポイントにリクエストを送信させます。API キーが公開されたコードやスクリーンショットに貼り付けられたことがあれば、置き換えてください。

まだ解決しない場合

コピーしたばかりのキーでもcurlテストで401を返す場合、APIキーページからキーを再生成し、コマンドにそのまま貼り付けてもう一度試してください。それでも失敗する場合は、リクエストの時刻、エンドポイント、およびX-Request-Idレスポンスヘッダーをサポートチームに送信してください。メッセージにキー全体を絶対に送信しないでください。先頭と末尾の4文字だけで識別可能です。

質問と回答

401はクレジットがなくなったことを意味しますか?

いいえ。401は認証に関するエラーです:キーが存在しない、形式が正しくない、または不明です。クレジットの枯渇は別の状態です。

同じキーがcurlでは動作するが、アプリでは動作しないのはなぜですか?

あなたのアプリは、古い環境変数、引用符付きの.envエントリ、または末尾に空白のあるAPI キーなど、異なる値を読み込んでいる可能性があります。実際に使用しているAPI キーの長さとrepr関数の出力を出力してください。

OpenAIキーをこのAPIで使用できますか?

いいえ。各キーは発行元のホストでのみ機能します。APIキーページのキーと、このサイトのベースURLを使用してください。

401は課金されますか?

いいえ。失敗または拒否されたリクエストは課金されません。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

API キーを取得