概述
根据用户输入的消息内容，由大模型生成一个简短的会话标题。接口采用 HTTP SSE 方式返回：服务端在生成期间定时推送心跳，生成完成后推送标题事件并结束连接。
本接口只生成标题，不会修改已有会话的标题。如需保存标题，请自行调用会话修改接口。
调用本接口会消耗应用的模型 Token。
1. HTTP SSE 接口请求
1.1 调用流程
1.2 请求说明
请求地址：
https://wss.lke.cloud.tencent.com/adp/v2/chat/optimize/title/generate请求方式：POST
请求头：
Content-Type: application/json前提条件：应用已发布。
1.3 获取 Token
项 | 值 |
接口名（Action） | CreateSSEToken |
产品 | adp |
版本（Version） | 2026-05-20 |
入参 | AppId（String，必填）：应用 ID |
出参 | Token（String）：SSE Token |
Token 使用规则：
调用 CreateSSEToken 的账号必须是应用所属主账号或其子账号，否则返回无权限。
Token 一次性使用：鉴权通过后即被消费，同一个 Token 不能重复调用本接口。
Token 有效期较短，请在获取后立即发起调用；每次生成标题都需要重新获取 Token。
1.4 参数说明
名称 | 类型 | 必选 | 描述 |
Token | String | 是 | |
UserId | String | 是 | 用户 ID，与对话接口的 UserId 含义一致。 |
Contents | 是 | 用于生成标题的消息内容。仅支持 text 类型 | |
RequestId | String | 否 | 请求 ID，用于问题排查。建议使用 uuid 生成，规则同对话接口： ^[a-zA-Z0-9_-]{32,64}$ |
Contents 中各类型内容的使用方式：
Type | 使用字段 | 说明 |
text | Text | 取去除首尾空格后的文本 |
1.5 curl 示例
# 1. 获取 Token（以云 API 3.0 调用 CreateSSEToken，入参 {"AppId": "<应用ID>"}）# 2. 生成标题curl -N -X POST 'https://wss.lke.cloud.tencent.com/adp/v2/chat/optimize/title/generate' \\-H 'Content-Type: application/json' \\-d '{"RequestId": "c3a1d2b4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","Token": "<CreateSSEToken 返回的 Token>","UserId": "user_001","Contents": [{"Type": "text", "Text": "帮我总结一下这份季度销售报告，并给出下季度的改进建议"}]}'
成功时的返回：
event: conversation.title.generateddata: {"Type":"conversation.title.generated","Timestamp":"1761724800123","Conversation":{"Title":"Q3销售报告总结与改进建议"}}event: donedata: [DONE]
生成耗时超过 30 秒时，标题事件之前会先收到一条或多条
heartbeat 事件。2. HTTP SSE 接口返回
所有事件均为后端推送到前端。每个事件格式为
event: <事件名>\\ndata: <JSON>\\n\\n。Timestamp 等 int64 字段以字符串形式返回。事件 JSON 中可能还带有本接口不使用的空值字段（如
RecordId、ConversationId），调用方忽略即可。2.1 心跳
event: heartbeat标题生成期间每 30 秒推送一次，用于保活。调用方收到后忽略即可。
名称 | 类型 | 描述 |
Type | String | 事件类型，固定为 heartbeat |
Heartbeat | 心跳信息 | |
Timestamp | String | 事件时间戳，毫秒 |
示例：
event: heartbeatdata: {"Type":"heartbeat","Heartbeat":{"Elapsed":"30001","StartTime":"1761724770122","TraceId":"8f3c1e0a9b7d4c2e"},"Timestamp":"1761724800123"}
2.2 标题生成完成
event: conversation.title.generated名称 | 类型 | 描述 |
Type | String | 事件类型，固定为 conversation.title.generated |
Conversation | 标题信息，读取 Conversation.Title | |
Timestamp | String | 事件时间戳，毫秒 |
该事件之后服务端会发送
event: done / data: [DONE] 并关闭连接。2.3 错误
event: error请求参数错误、鉴权失败、限流、模型调用失败等情况均以该事件返回，HTTP 状态码仍为 200。返回
error 事件后连接直接关闭，不会再发送 done 事件。名称 | 类型 | 描述 |
Type | String | 事件类型，固定为 error |
Error | 错误信息 |
示例：
event: errordata: {"Type":"error","Error":{"Code":460001,"Message":"Token 校验失败","TraceId":"8f3c1e0a9b7d4c2e"}}
3. 数据结构
3.1 Content
名称 | 类型 | 描述 |
Type | String | 内容类型： text |
Text | String | 文本内容， Type 为 text 时使用 |
3.2 Heartbeat
名称 | 类型 | 描述 |
Elapsed | String | 从开始生成到当前的耗时，毫秒 |
StartTime | String | 开始生成的时间戳，毫秒 |
TraceId | String | 链路 ID，用于问题排查 |
3.3 Conversation
名称 | 类型 | 描述 |
Title | String | 生成的会话标题 |
3.4 Error
名称 | 类型 | 描述 |
Code | Number | |
Message | String | 错误信息 |
TraceId | String | 链路 ID，用于问题排查 |
4. 错误码
错误码 | 说明 | 处理建议 |
400 | 请求参数错误：请求体不是合法 JSON，或 Token、UserId 为空，或 Contents 中没有有效内容 | 检查请求参数 |
460001 | Token 校验失败：Token 无效、已过期或已被使用 | 重新调用 CreateSSEToken 获取 Token |
460004 | 应用不存在 | 检查 CreateSSEToken 传入的 AppId，确认应用已发布 |
460011 | 超出并发数限制 | 稍后重试 |
460032 | 当前应用模型余额不足 | 充值或购买资源包 |
460502 | 生成的标题未通过内容安全审核 | 调整输入内容后重试 |
460701 | 专属模型超出并发数限制 | 稍后重试 |
460702 | 专属模型余额不足 | 充值或购买资源包 |
460711 / 460712 / 460713 | 触发空间的模型 TPM / QPM / 单日 Token 上限 | 稍后重试或调整空间限额 |
460721 / 460722 / 460723 | 触发应用的模型 TPM / QPM / 单日 Token 上限 | 稍后重试或调整应用限额 |
500 | 服务内部错误（含模型调用失败、模型返回空标题） | 稍后重试，持续失败时提供 TraceId 排查 |
