トラブルシューティング
症状別の索引：発生している症状を見つけ、原因の説明に移動できます。
再試行する前にアクセス権を確認
- 意図した利用権が有効か確認し、その有効期限を記録してください。
- キーが意図したグループを使用していることを確認してください。期間制の Claude プランは次を使用します Claude Unlimited。Codex のアクセス権は別です。
- 同じキーでモデル一覧を取得し、返された ID を選択して、小さなリクエストを送信してください。
使用するモデルは、 モデルとキーグループ または エージェント設定チェックリスト を参照してください。どの手順で失敗したか不明な場合に役立ちます。
まったく動作しない
ほかの問題を調べる前に、基本的な動作を確認してください。
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"モデル一覧の取得に成功したら、選択したモデルが一覧にあることを確認し、小さな生成リクエストを送信してください。モデルの可用性、利用権、制限、クライアント設定によっては、生成が失敗することもあります。
症状別
| 症状 | 考えられる原因 | 対処方法 |
|---|---|---|
404 呼び出すたびに | ベース URL での次の扱いが誤っています /v1 の扱い | ベースURL |
401 作成したばかりのキーで | 形式に合わないヘッダー、または末尾の空白 | 認証 |
402 | クレジットがない、またはプランの有効期限切れ | チャージ · プラン |
400 max_tokens | Messages には次が必要です max_tokens。Chat Completions には不要です | Messages |
model_not_found | ID が誤っている、キーのグループが誤っている、またはそのキーではモデルを利用できない | モデルとキーグループ |
| ストリーミングは接続されるが何も返ってこない | 別の形式のイベント構造として解析している | ストリーミング |
| 応答が文の途中で途切れる | stop_reason: max_tokens | 増やす max_tokens |
| curl では動作するが SDK では失敗する | SDK がベース URL に独自のパスを追加している | ベースURL |
| ダッシュボードに使用量が表示されない | リクエストが別のキーまたはエンドポイントに送信されている | 確認する項目： ANTHROPIC_API_KEY が未設定です — Claude Code |
頻繁に発生する 429 | エージェントの並列実行数が多すぎる | レート制限 |
| 請求額が予想より高い | ターンを重ねるごとにコンテキストが増える | コンテキスト管理 |
エラーボディの読み方
ステータスコードは問題の分類を示し、 error.type と error.message フィールドは具体的な問題を示します。ボディ全体をログに記録してください — 400 置き換え先： "missing max_tokens" および 400 置き換え先： "invalid role" では、まったく異なる対処が必要です。
解決しない場合
お問い合わせ先： support@aiprimetech.io に、エンドポイント、モデル ID、ステータスコード、エラーボディを添えて連絡してください。API キーは絶対に含めないでください。すでにどこかに貼り付けた場合は、まず失効させてください。