更新日:
DeepSeek API キーが動作しない:原因と解決策
deepseek API キーが機能しないエラーが発生した場合、キー自体が原因であることはあなたが考えるよりも少ない頻度です。ほとんどの失敗は、Base URL、残高の空欄、間違ったモデル名、またはキーを間違った場所に送信するクライアントに起因します。


1行のテストから始めましょう
アプリの何かを変更する前に、クライアントを除外してください。単一の curl コマンドで、キー、URL、モデル名が一緒に動作するかどうかを確認できます。プレースホルダーをプロバイダーのダッシュボードとドキュメントの値に置き換えてください。
curl -i https://YOUR-PROVIDER/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'
-iフラグはステータス行とヘッダーを出力し、それらは本文よりも重要です。curl が動作してアプリが動作しない場合、問題はアプリの設定にあります。curl も失敗する場合、問題はキー、アカウント、またはエンドポイントにあります。
まずステータスコードを読み取ります
| ステータス | 一般的な意味 | 確認すべき項目 |
|---|---|---|
| 401 | キーが拒否されました | コピーミス、余分なスペース、取り消しまたは削除されたキー、異なるプロバイダーのキー |
| 402 または残高メッセージ | クレジットがありません | アカウント残高と請求ページ |
| 404 | パスまたはモデルが間違っている | ベースURL、末尾の /v1、モデル名のスペルミス |
| 429 | リクエストが多すぎます | 1分あたりのリクエスト数、並列呼び出し、リトライヘッダー |
| 5xx またはタイムアウト | プロバイダー側またはネットワーク | プロバイダーのステータスページ、後で再試行、地域ルーティング |
これらは OpenAI 互換プロバイダー全体で一般的な意味合いです。各プロバイダーは独自の正確なコードを文書化しているため、詳細については現在のドキュメントを確認してください。
キー自体
キーは長い文字列であり、地味な方法で壊れることがあります。キーをプレーンテキストエディタに貼り付け、末尾のスペースや改行、先頭の引用符、チャットアプリによって追加された改行がないか確認してください。ヘッダーは Authorization: Bearer KEY とし、Bearer の後に単一のスペースがあることを確認してください。キーを環境変数に設定する場合は、その値ではなくアプリ内で長さを出力して読み込まれたことを確認してください。
他の 2 つのケースも一般的です。まず、キーを作成してページを閉じ、マスクされたバージョンをコピーしてしまっています。ほとんどのダッシュボードはキーを 1 回だけ表示するため、新しいキーを作成してください。第二に、あるサービスのキーを別のサービスの URL で使用しています。キーは、発行したプロバイダーに対してのみ有効です。
残高、請求、無料クレジット
多くの API キーは、アカウントにクレジットがある間のみ機能します。残高ゼロは、キーの故障のように見えることがあります。プロバイダーの請求ページを開き、資金があること、チャージが実際に決済済みであること、プロモーションクレジットが期限切れでないことを確認してください。暗号資産やカードによるチャージは、反映されるまでに数分かかる場合があります。
別の前払いサービスがこれをどのように処理するかを比較したい場合は、当社のモデルはシンプルです:クレジットを購入し、呼び出しは 1M 入力トークンあたり $0.15、1M 出力トークンあたり $0.50 でクレジットを消費し、失敗または拒否されたリクエストは請求されず、クレジットは期限切れになりません。残高は GET /v1/balance または各レスポンスの X-Balance-USD ヘッダーで確認できます。
ベースURLとモデル名
SillyTavern、Janitor AI、エディタプラグインなどのツールで最も多い原因は、ベースURL の入力ミスです。よくある間違い:/v1の欠落、/v1/v1の二重入力、httpをhttpsの代わりに使用、すでに追加されるフィールドに/chat/completionsを貼り付け。モデルフィールドも罠です。プロバイダがリストするモデル ID と一致する必要があります。プロバイダが対応している場合はGET /v1/modelsで一覧を取得するか、または現在のドキュメントをお読みください。
特定のツールのセットアップガイドは当サイトにあります:SillyTavern でのキーの使用、Janitor AI での使用、VS Code での使用。
レート制限と同時実行数
同時リクエストのバーストは、有効なキーでも 429 を引き起こす可能性があります。Retry-After ヘッダーを探し、バックオフしてください。Python の最小限のリトライは次のようになります。
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")
def ask(prompt):
for attempt in range(4):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")
当社のエンドポイントでは、完全なキーで 8 件の同時リクエストと 1 分あたり 300 件のリクエストが許可されます。ストリーミングリクエストは、ストリームが終了するまでスロットを保持します。エラーコードは rate_limited または concurrency で、一時的な過負荷は Retry-After: 5 で 429 を返します。
ネットワークと地域の問題
curl がハングアップまたはリセットする場合、問題はあなたとプロバイダの間にある可能性があります:企業のプロキシ、VPN、DNS、または地域ブロック。異なるネットワークを試す、プロキシが Authorization ヘッダーを通過することを確認する、長時間の生成のためにクライアントのタイムアウトを上げる。ストリーミングレスポンスはバッファリングするプロキシによって切り捨てられる可能性もあるため、stream: false でテストして2つの問題を分離してください。
5分で実行できるチェックリスト
- curl テストを実行し、ステータスコードを記録します。
- 新しいキーを作成してテストします。新しいキーが動作する場合、古いキーは間違ってコピーされたか取り消されました。
- クレジットの残高と有効期限を確認してください。
- ベースURLとモデル ID をプロバイダーのドキュメントと文字単位で比較します。
- ストリーミングなし、ツールなし、短いプロンプトで 1 件のリクエストを送信します。機能を 1 つずつ追加します。
- 同時呼び出しを確認します。アプリが一度に複数のリクエストを送信する場合、同時接続数を減らしてください。
- 別のネットワークを試すか、VPN をオフにします。
- リクエスト ID を含むレスポンスヘッダーを確認します。サポートチームはその ID から呼び出しを見つけることができます。
ステップ 5 は驚くべき数のバグを見つけます。わずかに無効なツール定義、非常に大きな max_tokens 値、またはサイズ制限を超えるボディは、キーの問題のように見えるエラーを返すことがあります。当社のエンドポイントではボディ制限は 8 MB で、すべてのレスポンスにはサポートに引用できる X-Request-Id ヘッダーが含まれます。
バックアップエンドポイントを設定する
障害や制限はどのプロバイダーでも発生するため、設定に2つ目のOpenAI互換エンドポイントを追加してください。当社のサービスは、法令に則った成人向け利用においてコンテンツ拒否なしで回答するようにチューニングされたホスト型のオープンウェイトモデルです。これはDeepSeekの公式APIではなく、ルーターでもありません。異なる回答や動作が期待されます。切り替えには2つの設定が必要です。base URL は https://api.deepseekapikey.com/v1、モデルは uncensored に設定します。
curl https://api.deepseekapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
新規ユーザーは、API keyページでワンクリックで$0.50のトライアルクレジットを取得できます。有効期限は7日間です。チャージは暗号資産で$20から$500まで実行可能です。詳細は価格ページおよびドキュメントをご覧ください。
その他のガイド
質問と回答
なぜcurlではキーが機能するがアプリでは機能しないのか?
アプリのbase URLが間違っているか、モデル名が間違っているか、キーの古いコピーが使用されている可能性があります。設定を、正常に動作するcurl呼び出しと1文字ずつ比較してください。
有効なキーがあれば、リクエストが必ず成功する保証がありますか?
いいえ。残高ゼロ、レート制限、または不明なモデル名は、すべて完全に有効なキーでも失敗を引き起こす可能性があります。
異なるプロバイダーでも同じコードを使用できますか?
両方がOpenAI互換であれば、はい。base URL、キー、およびmodel IDを変更してください。
あなたのエンドポイントはDeepSeekと同じモデルですか?
いいえ。これは独立したプロバイダーが運用するオープンウェイトモデルの1つであり、どのベンダーの公式APIでもありません。
キーはフォーム1つで入手できます
アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。