Conversations
/v1/conversations· クロスデバイス会話同期(chat サイトで使用)
軽量な会話クラウド同期 API です。会話タイトル、メッセージ配列、任意のクライアントメタデータを保存します。モデル API ではなく、 生成課金は発生しません。会話内容は所有者のみが閲覧できます。
オブジェクト#
{
"id": "0f3c2f3a-8a0e-4c1e-9f0a-2b7c9d1e4a11",
"user_id": 24,
"title": "关于向量数据库",
"messages": [
{
"role": "user",
"content": "什么是向量数据库?",
"timestamp": "2026-11-19T02:00:00Z",
"id": "msg_local_1",
"reasoning": "",
"sources": []
}
],
"metadata": {"model": "nexith-core"},
"created_at": "2026-11-19T02:00:00Z",
"updated_at": "2026-11-19T02:05:00Z"
}messages[].extra のクライアント追加フィールド(メッセージ id、推論、引用、成果物など)はそのまま保存され、そのまま返却されます。
サーバーは解析しません。
GET /v1/conversations#
現在のユーザーの会話を updated_at の降順で最大 100 件一覧表示します。
{"data": [ /* Conversation */ ], "total": 1}POST /v1/conversations#
{
"title": "新会话",
"messages": [],
"metadata": {"model": "nexith-core"}
}作成後の完全なオブジェクトを返します。
GET /v1/conversations/:id#
単一の会話を返します。現在のユーザーに属さない場合は 404 not_found を返します。
PATCH /v1/conversations/:id#
更新可能なフィールド(すべて任意):title、messages、metadata。
{"title": "改名后的标题"}DELETE /v1/conversations/:id#
成功時は 204 No Content を返します。存在しない場合は 404 を返します。
認証とエラー#
- 認証が必要です(JWT または
nx-Key)。user_idごとに分離されます。 - 共通のエラー形式はエラーとレート制限を参照してください。