AI 对话:聊天记录
获取聊天记录
GET /external/api/v1/sseStream/messages?conversationId={conversationId}&page=1&pageSize=50
此接口需要 OAuth2 chat scope,只能查询当前用户自己的会话。会话不存在、已删除或不属于当前用户时,返回 404。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
conversationId | long | 是 | — | 会话 ID |
page | int | 否 | 1 | 页码,从 1 开始 |
pageSize | int | 否 | 50 | 每页数量,范围 1–100 |
消息按创建时间正序返回,因此可按页顺序直接渲染聊天记录。
{
"code": 200,
"msg": "success",
"data": {
"conversationId": 1950000000000000000,
"page": 1,
"pageSize": 50,
"total": 2,
"list": [
{
"id": 1950000000000000001,
"conversationId": 1950000000000000000,
"role": "user",
"content": "帮我解释 B+ 树",
"status": 1,
"promptTokens": 0,
"completionTokens": 0,
"totalTokens": 0,
"createdAt": "2026-08-10T10:00:00.000+00:00"
},
{
"id": 1950000000000000002,
"conversationId": 1950000000000000000,
"role": "assistant",
"content": "B+ 树是一种平衡多路搜索树……",
"reasoning": null,
"status": 1,
"promptTokens": 20,
"completionTokens": 180,
"totalTokens": 200,
"createdAt": "2026-08-10T10:00:01.000+00:00"
}
]
}
}
| 消息字段 | 说明 |
|---|---|
role | user 或 assistant |
status | 0 表示生成中,1 表示已完成 |
content | 用户输入或模型回复;生成中可能为空或仅有部分内容 |
reasoning | 上游返回的推理内容(若模型提供) |
promptTokens / completionTokens / totalTokens | 本条完成回复的 token 统计 |
实时输出请使用 AI 聊天 WebSocket。