デザインパートナー段階です。 公開エンドポイント
api.schneeai.comは一般提供開始時に有効になります。以下の例のhttps://api.schneeai.comはプレースホルダーです — デザインパートナーには、オンボーディング時にパートナー専用のエンドポイントと API キーをお渡しします。スニペット中のホスト名はパートナーエンドポイントに置き換えてください。
クイックスタート
AI Gateway を通じて最初のリクエストを送信。
Gateway は認証、ルーティングとリミットポリシーの適用、選択されたプロバイダーの呼び出し、構造化された利用の記録を行い、レスポンスを返します。
SchneeAI を初めて使う方は チュートリアル でストリーミング、名前付きプロンプト、エラーハンドリング、コスト追跡を一通りどうぞ — curl / Python / TypeScript のコピー実行可能なコード付き。
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: "gpt-4o-mini"と単一ユーザーメッセージによる最小リクエスト。("auto"— router が routing policy に基づいて選ぶ機能 — はロードマップ上。フェイルオーバー設計 参照。) - 名前付きプロンプト — 登録されたプロンプト名と変数で Gateway を呼び出し。
- 予算対応呼び出し — フィーチャータグを渡して支出を正しい予算に帰属。
SDK (近日公開)
Go と TypeScript SDK がロードマップにあります。現在は任意の HTTP クライアントで統合できます — REST API が真実のソースであり、SDK はその形状に従います。
コスト電卓
主要 LLM プロバイダー間の 1リクエスト / 月間コストをトークンコスト電卓で試算できます。先にトークン数を把握したい場合は、トークンカウンタ & PII スキャナーにプロンプトを貼り付けてください — リクエストが境界を出る前にシークレットや PII を検出します。
開発者ツール
- モデルディレクトリ — Gateway がルーティングする全モデルと実効価格、機能フィルタ。
- プロンプトテンプレートライブラリ — 要約 / RAG / コードレビュー / 抽出 / PII マスキングの本番向けプロンプト集。コピーして複数モデルで試せます。
- コスト電卓 — トークン単価比較と、自社構築 vs SchneeAI のインタラクティブ TCO。
- LLM 価格ベンチマーク — OpenAI / Anthropic / Google / Mistral / Cohere / DeepSeek / Meta / xAI 横断のトークン単価目安。月次更新。
- トークン & PII スキャナー — クライアントサイドでトークン化し、PII パターンを事前検出。
- エラーハンドリング — HTTP ステータスリファレンス、SchneeAI 独自エラーコード、リトライ戦略、チャット補完の冪等性。
- API リクエストビルダー — 同じフォームから curl / Python / TypeScript / Go の実行可能スニペットを生成するインタラクティブビルダー。
- サービス状況 — Gateway / Console / Vault / 上流プロバイダーの稼働状況。
キャッチアップ
新しいエンドポイント、破壊的変更、リリースノートはまず変更履歴に掲載されます。件名に “Subscribe” と書いて [email protected] までメールをいただければ、お知らせリストに追加します。