TalkSeed API ドキュメント

外部アプリケーションからペルソナを利用するためのAPI仕様

概要

TalkSeed APIを使用すると、公開されたペルソナと外部アプリケーションから対話できます。 RESTful APIとして提供され、認証なしで公開ペルソナにアクセス可能です。

REST API
JSON形式
認証不要（公開ペルソナ）
CORS対応

ベースURL

http://localhost:3001/api/trpc

POST /external.chat

公開ペルソナとチャット形式で対話します

POST

リクエストパラメータ

personaId
必須

型: string (UUID) - 対話するペルソナのID

message
必須

型: string (1-2000文字) - ペルソナに送信するメッセージ

レスポンス

{
  "success": true,
  "data": {
    "response": "ペルソナからの応答メッセージ",
    "personaName": "ペルソナ名",
    "timestamp": "2024-01-01T00:00:00.000Z"
  }
}

コード例

cURL
curl -X POST "http://localhost:3001/api/trpc/external.chat" \
  -H "Content-Type: application/json" \
  -d '{
    "personaId": "YOUR_PERSONA_ID",
    "message": "こんにちは"
  }'
JavaScript / TypeScript
const response = await fetch("http://localhost:3001/api/trpc/external.chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    personaId: "YOUR_PERSONA_ID",
    message: "こんにちは"
  })
});
const data = await response.json();
console.log(data.data.response);
Python
import requests

response = requests.post(
    "http://localhost:3001/api/trpc/external.chat",
    json={
        "personaId": "YOUR_PERSONA_ID",
        "message": "こんにちは"
    }
)
data = response.json()
print(data["data"]["response"])

エラーコード

404
NOT_FOUND

ペルソナが見つからない、または非公開

500
INTERNAL_SERVER_ERROR

サーバーエラー（応答生成失敗等）

400
BAD_REQUEST

リクエストパラメータが不正

使用制限とベストプラクティス

レート制限

  • 開発環境: 制限なし
  • 本番環境: 500リクエスト/15分/IP（予定）

推奨事項

  • エラーハンドリングを適切に実装してください
  • タイムアウト設定を3分以上に設定してください（LLM応答生成に時間がかかるため）
  • レスポンスをキャッシュして無駄なリクエストを減らしてください

サポート・お問い合わせ

APIに関するご質問やサポートが必要な場合は、以下からお問い合わせください。

support@talkseed.comGitHub