クイックスタート
最初のパネル作成までの3ステップ
2
SDKをインストール
コマンドは1つだけ。requests以外の依存関係はありません。
pip install kronaxis
3
最初のパネルを作成
ターゲットとなる人口統計を定義し、最初の質問をしてください。数分で結果が得られます。
Python SDK
数分で本番環境に対応
Python
from kronaxis import PanelStudio ps = PanelStudio(api_key="your_key") # Create a panel panel = ps.panels.create( name="UK Retail Panel", country="GB", size=100, demographics={"age_range": "25-54"} ) # Run a stimulus result = ps.conversations.create( panel_id=panel["id"], stimulus="Your favourite brand just increased prices by 20%. What do you do?", sample_size=50 ) # Export results ps.export.jsonl(panel["id"], path="results.jsonl")
主要なエンドポイント
主要なAPIルート
Panel Studioは、パネル、ペルソナ、会話、エクスポート、調査、統合にわたる226のルートを公開しています。これらは最も一般的に使用されるものです。
| メソッド | Endpoint | 説明 |
|---|---|---|
| POST | /api/panels | 新しいパネルを作成 |
| GET | /api/panels | パネルを一覧表示 |
| POST | /api/panels/{id}/conversations | 会話を開始 |
| POST | /api/panels/{id}/conversations/{cid}/turns | フォローアップのターンを追加 |
| GET | /api/panels/{id}/personas | パネルのペルソナを一覧表示 |
| POST | /api/panels/{id}/export/jsonl | JSONLとしてエクスポート |
| POST | /api/panels/{id}/export/parquet | Parquetとしてエクスポート |
| POST | /api/panels/{id}/export/pptx | PowerPointとしてエクスポート |
| POST | /api/webhooks | ウェブフック購読を作成 |
| GET | /api/integrations | 利用可能な統合を一覧表示 |
認証
シンプルなAPIキー認証
すべてのリクエストでX-API-KeyヘッダーにAPIキーを渡してください。キーは登録時に即座に発行されます。
curl -H "X-API-Key: your_key" \
https://panel.kronaxis.co.uk/api/panels
無料ティア
月間10ペルソナ、10質問。完全なAPIアクセス。クレジットカードは不要です。
有料ティア
無制限のペルソナと質問。因果推論のトレース。優先サポート。詳細は価格設定をご覧ください。
ウェブフック
リアルタイムイベント配信
すべてのウェブフックは、秘密鍵を使用してHMAC SHA-256で署名されています。サーバー側でX-Kronaxis-Signatureヘッダーを検証し、信頼性を保証してください。配信失敗時には指数関数的バックオフで再試行されます。
conversation.completed
ターンに対するすべてのペルソナ応答が収集されたときに発生します。
panel.created
新しいパネルの構築が完了し、ペルソナの準備ができたときに発生します。
export.ready
JSONL、Parquet、またはPPTXのエクスポートファイルがダウンロード可能になったときに発生します。