よくある質問

コード	意味	よくある原因	対処方法
200	成功	正常応答。ただし内容が空、または SSE に data がない場合は endpoint の組み合わせ違いの可能性	モデルに対応する endpoint を確認
400	リクエスト形式エラー	JSON 不正、必須項目不足、モデル名の誤字、パラメータ超過	リクエスト内容を確認し JSON を検証
401	未認証	API key の欠落、誤り、停止、またはネットワーク問題	ダッシュボードで key 状態を確認
403	権限不足	対象モデルまたはトークングループの権限なし	グループ権限を確認、またはサポートへ連絡
404	パスまたはモデルが存在しない	URL の誤り、または利用可能リストにないモデル	/v1/models を確認し URL を再確認
413	リクエスト内容が大きすぎる	prompt または input が context 上限超過	入力を短くする、または分割処理
429	レート制限 / quota 不足	QPS 超過、残高または quota 不足	並列数を下げ、quota を確認
500	upstream 内部エラー	上流モデルサービスの異常	30 秒後に再試行
502	gateway エラー	gateway から upstream への接続異常	1 分後に再試行
503	サービス利用不可	upstream の過負荷またはメンテナンス	1-5 分後に再試行
504	gateway timeout	upstream 応答が遅い、または prompt が長すぎる	入力を短くする、streaming を有効化
524	timeout	Cloudflare timeout	複数回試す