调用ListHotTopics获取热点话题列表-大模型服务平台百炼-阿里云-大模型服务平台百炼(Model Studio)-阿里云帮助中心

获取热点话题列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aimiaobi:ListHotTopics

list

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
AgentKey	string	是	业务空间唯一标识： AgentKey	xxxxx_p_efm
TopicSource	string	否	热榜源筛选，支持的热榜源。热榜源详见 API：ListHotSources Aggregation：表示聚合后的全国热点话题榜	Quark
Topics	array	否	热榜主题事件筛选
	string	否	热榜主题事件名称	xxx
TopicVersion	string	否	数据版本筛选	数据版本筛选
TopicQuery	string	否	根据热榜主题全文检索	根据热榜主题全文检索
TopicIds	array	否	热榜主题 ID 列表
	string	否	热榜主题 ID	xxxxxx
WithNews	boolean	否	响应是否包含新闻	true
NextToken	string	否	下一页的 token	下一页的token
MaxResults	integer	否	最大返回结果数	1
CustomField	string	否	自定义业务字段筛选（keyword 精确匹配），长度上限 255 字符	biz-tag-001
CreateTimeStart	string	否	话题创建时间筛选起点（包含），格式：yyyy-MM-dd HH:mm:ss	2026-06-01 00:00:00
CreateTimeEnd	string	否	话题创建时间筛选终点（包含），格式：yyyy-MM-dd HH:mm:ss	2026-06-04 23:59:59

返回参数

名称	类型	描述	示例值
	object	PageResult2
Code	string	状态码	NoData
Data	array<object>	业务数据
	array<object>	热点事件列表
AsyncTaskId	string	异步任务 ID（自定义主题场景下使用）	异步任务ID（自定义主题场景下使用）
CreateUser	string	创建用户 ID（自定义主题场景下使用）	创建用户ID（自定义主题场景下使用）
HotValue	integer	热度值	61
Id	string	热榜 ID	热榜ID
Status	string	异步任务状态（自定义事件场景下使用） (PENDING: 待执行, RUNNING: 执行中, SUCCESSED: 成功, SUSPENDED: 暂停, FAILED: 失败, CANCELED: 取消)	FAILED
StructureSummary	array<object>	结构化主题摘要列表
	array<object>
DocList	array<object>	生成该标题摘要引用的文章
	object
Source	string	文章来源	夸克
Title	string	文章标题	xxxxx
Url	string	文章 URL	http://www.example.com
Summary	string	摘要	摘要
Title	string	标题	标题
Summary	string	热榜摘要	热榜摘要
TaskErrorMessage	string	异步任务失败错误信息	异步任务失败错误信息
TaskStatus	integer	异步任务状态。0-待执行，1-执行中，2-执行成功，3-暂停（暂不使用），4-执行失败，6-任务取消（自定义事件场景下使用）	26
Topic	string	主题唯一名称	主题唯一名称
TopicSource	string	热榜源，目前支持的热榜源： Toutiao：头条 Quark：夸克 Baidu：百度 Sina：新浪 Custom：自定义 Aggregation：热点话题榜	Toutiao
Version	string	数据版本	数据版本
CustomField	string	自定义业务字段（keyword）	biz-tag-001
CreateTime	string	话题创建时间，格式：yyyy-MM-dd HH:mm:ss	2026-06-04 12:34:56
TopicUrl	string	话题原文链接	https://www.example.com/topic/123
HttpStatusCode	integer	http 状态码	200
MaxResults	integer	最大返回结果数	94
Message	string	错误说明	success
NextToken	string	下一页的 token	下一页的token
RequestId	string	请求唯一标识	1813ceee-7fe5-41b4-87e5-982a4d18cca5
Success	boolean	是否成功：true 成功，false 失败	true
TotalCount	integer	总数	23

示例

正常返回示例

JSON格式

{
  "Code": "NoData",
  "Data": [
    {
      "AsyncTaskId": "异步任务ID（自定义主题场景下使用）",
      "CreateUser": "创建用户ID（自定义主题场景下使用）",
      "HotValue": 61,
      "Id": "热榜ID",
      "Status": "FAILED",
      "StructureSummary": [
        {
          "DocList": [
            {
              "Source": "夸克",
              "Title": "xxxxx",
              "Url": "http://www.example.com"
            }
          ],
          "Summary": "摘要",
          "Title": "标题"
        }
      ],
      "Summary": "热榜摘要",
      "TaskErrorMessage": "异步任务失败错误信息",
      "TaskStatus": 26,
      "Topic": "主题唯一名称",
      "TopicSource": "Toutiao",
      "Version": "数据版本",
      "CustomField": "biz-tag-001",
      "CreateTime": "2026-06-04 12:34:56",
      "TopicUrl": "https://www.example.com/topic/123"
    }
  ],
  "HttpStatusCode": 200,
  "MaxResults": 94,
  "Message": "success",
  "NextToken": "下一页的token",
  "RequestId": "1813ceee-7fe5-41b4-87e5-982a4d18cca5",
  "Success": true,
  "TotalCount": 23
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。