よくある質問

すばやく確認する

コードでエラーが発生したら、まず HTTP ステータスコード（例：401、429）を確認し、以下を参考に対処してください：

401 - API Key が無効

最も一般的な原因：

• コピー時に余分なスペースが入っている
• 形式が正しくない（sk- で始まっていない）
• キーが削除されている

すぐに解決するには：

コンソールに移動して、キーを再度コピーするか、新しいキーを作成してください。

402 - 残高不足

アカウント残高が今回のリクエストの支払いに足りません。

料金センターに移動してチャージしてください。

注意： 長いコンテキストのリクエスト（Gemini で 100 万 tokens を処理する場合など）では、発生する可能性のある最大料金が事前に引き落とされます。残高が十分にあることを確認してください。

404 - モデルが存在しない

よくある原因：

• モデル ID のスペルミス
• 古いモデル名を使用している（gpt-4o は gpt-6.1-sol に置き換えられています）
• Base URL のパスが正しくない

解決方法：

Base URL が https://api.onemux.net/v1 であることを確認してください（末尾に /v1 があることに注意）

429 - リクエストが多すぎる

短時間に過剰な数のリクエストを送信したため、レート制限が適用されています。

解決方法：

• リクエスト頻度を下げる
• 10-30 秒待ってから再試行する
• 自動再試行ロジックを追加する（エラー処理ドキュメントを参照）
• 並列タスクの数を減らす

500/502/503 - サービス障害

上流のモデルサービスが一時的に利用できません。

解決方法：

• 10-30 秒待ってから再試行する
• 別のモデルに切り替える
• ステータスページでサービスの状態を確認する

問題が特定できない場合の確認手順