ドキュメントはじめにはじめに
はじめに
SoleAPI の概要、ベース URL、3 つの API 方言の全体像。
SoleAPI はマルチモデル AI ゲートウェイです。1 つの API キーと 1 つの安定したエンドポイントで Claude、GPT、Gemini、Grok、DeepSeek などの主要モデルを呼び出せます。スマートルーティングとフェイルオーバー、トークン単位の課金、レート制限とクォータ管理、リクエストのマスキング、リアルタイム利用統計を標準装備しています。
ベース URL
すべてのリクエストは同一ホストに送信します：
https://api.soleapi.com公式 SDK では base_url を上記アドレスに向けるだけで、他のコードはそのままで動きます。
3 つの API 方言
ゲートウェイは 3 社の API 形式を同時に公開しており、1 つのキーですべて利用できます。既存のコードやツールが使っている形式を選んでください：
| 方言 | エンドポイント | 認証ヘッダー | 代表的なクライアント |
|---|---|---|---|
| OpenAI 互換 | POST /v1/responses | Authorization: Bearer | OpenAI SDK · Codex |
| Anthropic 互換 | POST /v1/messages | x-api-key | Anthropic SDK · Claude Code |
| Gemini 互換 | POST /v1beta/models/{model}:generateContent | x-goog-api-key | Google GenAI SDK |
ゲートウェイは必要に応じてプロトコル変換を行うため、多くの対話モデルはどの方言からでも呼び出せます。特定のプロトコルしか受け付けないモデルの場合は、その旨を明示したエラーが返ります（エラーコード参照）。
主な機能
- スマートルーティングとフェイルオーバー：複数の供給元から自動選択し、障害時は自動で切り替え・遮断・復旧します。
- トークン単位の課金：入力・出力（キャッシュ・推論トークンを含む）を個別に計算し、残高と履歴をいつでも確認できます。
- レート制限とクォータ：RPM/同時実行数の制限、キー単位の利用上限（周期リセット可）、IP 許可リスト。
- データマスキングとコンテンツコンプライアンス：設定可能なプライバシーフィルターが転送前に機密フィールドをマスキングし、コンテンツ審査がリスクのあるリクエストを遮断します。
- リアルタイム可観測性：ダッシュボードのトレンド、キー別利用統計、リクエスト単位の詳細ログ。