まずこの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_KEYBearer の単語が欠落している。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文字だけで識別可能です。
