NNexithDocs
ステータスダッシュボード ↗
概要とクイックスタートモデルカタログガイドAPI リファレンス連携OAuth2 / OIDC

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 ごとに分離されます。
  • 共通のエラー形式はエラーとレート制限を参照してください。