百炼轻应用-聚合热点播报下API:聚合热点问答。
接口说明
通过此接口,可以针对聚合热点和通用领域知识做问答。欢迎前往控制台体验。通过 SDK 方式调用 API 可参考控制台“API”下的示例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
quanmiaolightapp:RunHotTopicChat | none | *全部资源 * |
| 无 |
请求语法
POST /{workspaceId}/quanmiao/lightapp/runHotTopicChat HTTP/1.1
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
workspaceId | string | 是 | 百炼业务空间唯一标识,百炼首页左上角获取 | llm-xx |
modelId | string | 否 | 数据模型 ID。默认:qwen-max-latest | qwen-max-latest |
modelCustomPromptTemplate | string | 否 | prompt 模版 | xx |
generateOptions | array | 否 | 生成模式列表:默认 textChatGenerate | |
string | 否 | 生成模式:summaryChatGenerate、newsChatGenerate 和控制台第三步选项对应,可以直接使用,其他场景可以按需要组合
| newsChatGenerate | |
taskId | string | 否 | 对话任务唯一标识:多轮时,这个值保持不变 | a3d1c2ac-f086-4a21-9069-f5631542f5a2 |
originalSessionId | string | 否 | 原始会话唯一标识:重试场景 | a3d1c2ac-f086-4a21-9069-f5631542f5ax |
prompt | string | 否 | 用户问题 | 帮我播报体育热点 |
hotTopicVersion | string | 否 | 热榜版本 | 2024-09-13_12 |
category | string | 否 | 热榜频道 | 体育 |
hotTopics | array | 否 | 热点名称列表 | |
string | 否 | 热点标题名称 | xxx | |
imageCount | integer | 否 | 配图张数:不一定都有图,取值[1-3] | 1 |
stepForBroadcastContentConfig | object | 否 | 新闻播报内容配置:仅 Saas 用,Paas 调用建议走 hotTopicVersion | |
categories | array | 否 | 选择的频道列表 | |
string | 否 | 频道 | 体育 | |
customHotValueWeights | array<object> | 否 | 热度计算维度,不传,则走默认 | |
object | 否 | 热度计算维度列表 | ||
dimension | string | 否 | 权重维度唯一标识:
| comments |
weight | integer | 否 | 权重,0-10 之间 | 1 |
topicCount | integer | 否 | 话题数量 | 20 |
messages | array<object> | 否 | 上下文 | |
object | 否 | 角色:user、assistant、system | ||
role | string | 否 | 内容 | user |
content | string | 否 | 发生时间 | xxx |
createTime | string | 否 | 时间 | 2024-12-10 18:51:29 |
返回参数
示例
正常返回示例
JSON
格式
{
"header": {
"errorCode": "InvalidParam",
"errorMessage": "xx",
"event": "task-finished",
"eventInfo": "xx",
"sessionId": "xxx",
"taskId": "d3be9981-ca2d-4e17-bf31-1c0a628e9f99",
"traceId": "2150451a17191950923411783e2927"
},
"payload": {
"output": {
"articles": [
{
"content": "xxx",
"pubTime": "2024-09-22 16:45:06",
"score": 0.8,
"searchSourceName": "互联网",
"select": true,
"summary": "xx",
"title": "test",
"url": "http://xxx"
}
],
"hotTopicSummaries": [
{
"customHotValue": 100000,
"hotTopic": "xx",
"hotTopicVersion": "2024-09-13_08",
"hotValue": 100000,
"textSummary": "xxx",
"customTextSummary": "xxx",
"news": [
{
"title": "xxx",
"url": "http://xxx"
}
],
"images": [
{
"url": "http://xxx"
}
]
}
],
"multimodalMedias": [
{
"fileUrl": "http://xxxx",
"mediaType": "image",
"sortScore": 0.8
}
],
"recommendQueries": [
"关于xx你有什么看法?"
],
"searchQuery": "xxx",
"text": "xx"
},
"usage": {
"inputTokens": 100,
"outputTokens": 100,
"totalTokens": 200
}
},
"requestId": "04DA1A52-4E51-56CB-BA64-FDDA0B53BAE8"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | NoPermission | You are not authorized to perform this action , Please check the assignment of the workspaceId. | 请检查workspaceId的赋值 |
访问错误中心查看更多错误码。