開発者ガイド
ここから始めましょう:API キーを取得し、はじめての SDK 呼び出しを行い、あなた自身のサーバーに組み込みます。
API キーを取得する
コンソールで組織とアプリを作成し、SDK の呼び出しに使う client_id と client_secret を取得します。
統合パスを選ぶ
Quravin を呼び出す 4 つの方法 — プレーンな Web ページ、React SPA、Node.js サーバー、SDK なしの生の API。自分のスタックに合うものを選んでください。
認証モードを選ぶ
SDK を認証する 2 つの方法 — 静的な API キーが必要か、ユーザーごとの session JWT が必要かを判断する決定木。
プレーンな Web ページでの直接統合
任意のページに script タグを追加するだけ — ビルドステップもフレームワークも不要 — 静的またはサーバーレンダリングされた HTML ページから API を呼び出します。
React SPA 統合
小さなカスタムフックで Quravin SDK を React コンポーネントに組み込みます — クライアントインスタンスは 1 つ、実際の loading/error state を持ち、レンダーのたびに再インスタンス化しません。
Node.js サーバー統合
Node.js backend 向けの 2 つのパターン: ブラウザフロントエンド用に session token を発行するか、サーバー専用コードから直接 API を呼び出すか。
Direct API integration
SDK を使わず、プレーンな HTTP で API を呼び出す — どの言語でも可能です。curl の例付きで、匿名と認証済みの正確なリクエスト/レスポンスの形を示します。
ツールリファレンス
すべての組み込みツールの入力、有効な値、出力の形 — クイックスタートガイドの背後にある完全なリファレンスです。
Raw prompt mode
名前付きパイプラインの代わりに、カスタムの system/user プロンプトをモデルへ直接送信します — リクエストの形、そして名前付きパイプラインには適用されない制約について。