メッセージ送信
メッセージを送信すると、Snorbe のリサーチエージェントが調査を実行し、結果をテキストで返します。内部的にはユーザーチャットの作成、エージェント実行、応答の取得を一括で行います。
エージェントの実行には数十秒かかる場合があります。タイムアウトを長めに設定してください。
リクエスト
POST /api/trpc/chat.sendMessageWithApiKey
ヘッダー
| ヘッダー | 必須 | 説明 |
|---|
Authorization | はい | Bearer snorbe_... 形式の API キー |
Content-Type | はい | application/json |
リクエストボディ
tRPC の形式に従い、json キーで入力を渡します。
{
"json": {
"message": "半導体の最新トレンドを調べて",
"modelName": "snorbe-fast",
"locale": "ja",
"fileUrls": []
}
}
パラメータ
| パラメータ | 型 | 必須 | 説明 |
|---|
message | string | はい | エージェントに送るメッセージ |
modelName | string | はい | 使用するモデル名（下記参照） |
locale | string | いいえ | 応答言語。"ja" または "en"。デフォルト: "ja" |
fileUrls | string[] | いいえ | 添付ファイルの URL（最大10件） |
モデル名
| モデル名 | 説明 |
|---|
snorbe-fast | 高速モデル（推奨。コスト低、応答速い） |
snorbe-quality | 高品質モデル（精度重視） |
レスポンス
{
"result": {
"data": {
"json": {
"text": "半導体の最新トレンドについて調査しました。..."
}
}
}
}
レスポンスフィールド
| フィールド | 型 | 説明 |
|---|
text | string | エージェントの応答テキスト |
使用例
curl -X POST "https://app.snorbe.com/api/trpc/chat.sendMessageWithApiKey" \
-H "Authorization: Bearer snorbe_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"json":{"message":"半導体の最新トレンドを調べて","modelName":"snorbe-fast","locale":"ja"}}'
エラーレスポンス
| HTTP ステータス | コード | 説明 |
|---|
| 400 | BAD_REQUEST | バリデーションエラー（無効なモデル名など） |
| 401 | UNAUTHORIZED | API キーが無効、期限切れ、または未指定 |
| 429 | TOO_MANY_REQUESTS | レート制限超過 |
| 500 | INTERNAL_SERVER_ERROR | エージェント実行エラー |
