クイックスタート
AI Gateway を通じて最初のリクエストを送信。
Gateway は認証、ルーティングとリミットポリシーの適用、選択されたプロバイダーの呼び出し、構造化された利用の記録を行い、レスポンスを返します。
REST API
AI Gateway は OpenAI 互換のチャット補完エンドポイントを提供し、さらにプロンプト解決、利用照会、コントロールプレーン操作用のエンドポイントを備えます。
| 領域 | エンドポイント | 目的 |
|---|---|---|
| Chat | POST /v1/chat/completions | リクエストをモデルへルーティング |
| Prompts | GET /v1/prompts/{name} | アクティブなプロンプトバージョンを解決 |
| Usage | GET /v1/usage | 構造化された利用レコードを照会 |
| Budgets | GET /v1/budgets | 予算消費を確認 |
| Audit | GET /v1/audit | 監査イベントを読み取り |
完全なリクエスト・レスポンス形状は API リファレンスにあります。
認証
リクエストは SchneeAI が発行するベアラートークンを使用します。トークンはサービス・テナント・ユーザーのアイデンティティを携えるため、リミット、ログ、アクセス制御は常に呼び出し元を反映します。トークンはクライアントサイドコードに決して公開せず、AI 呼び出しはバックエンド経由でルーティングしてください。
例
- チャットエンドポイント —
model: "auto"と単一ユーザーメッセージによる最小リクエスト。 - 名前付きプロンプト — 登録されたプロンプト名と変数で Gateway を呼び出し。
- 予算対応呼び出し — フィーチャータグを渡して支出を正しい予算に帰属。
SDK (近日公開)
Go と TypeScript SDK がロードマップにあります。現在は任意の HTTP クライアントで統合できます — REST API が真実のソースであり、SDK はその形状に従います。
キャッチアップ
新しいエンドポイント、破壊的変更、リリースノートはまず変更履歴に掲載されます。件名に “Subscribe” と書いて [email protected] までメールをいただければ、お知らせリストに追加します。