本文档介绍热点资讯内容的输入输出参数。调用该接口需[付费开通](https://console.volcengine.com/ask-echo/product-information)热点资讯增值包功能，可获取基于大模型生成的热点资讯内容，内容包括丰富的资讯内容元素例如标题、标签、概要、详情、封面图等，您可根据这些数据自定义UI效果。免费试用状态下，每个火山账号ID，限流300QPM，限制调用上限100次。付费开通状态下，每个火山账号ID，限流300QPM。 # 认证方式提供APIKey接入和TOP网关接入两种方式，**两种接入方式有不同的URL**。 ## APIKey接入(推荐) 1. 获取API Key 1. 打开并登录[联网问答智能体-APIKey 管理](https://console.volcengine.com/ask-echo/api-key)。 2. 单击【联网问答Agent】页进入并创建API Key按钮。 3. 在弹出的名称文本框中填写API Key 名称，单击创建。 > 说明：请妥善保存好API Key，强烈建议您不要将其直接写入到调用模型的代码中。 2. 签名构造 API Key 签名鉴权方式要求在 HTTP 请求 header 中按如下方式添加 Authorization: ```Bash Authorization: Bearer ``` ## 火山引擎TOP网关接入此接入方式基于火山引擎IAM的AK/SK鉴权，统一使用 ServiceName=volc_torchlight_api 1. 接口验签及请求公共参数逻辑遵循火山引擎官网的统一规范，详情请参见：[签名方法--API签名调用指南-火山引擎](https://www.volcengine.com/docs/6369/67269)； 2. 开通账号权限后，可获取AccessKey进行验签，详情请参见：[Access Key(密钥)管理--API访问密钥(Access Key)-火山引擎](https://www.volcengine.com/docs/6291/65568)。注意： 1. 若使用主账号接入，可跳过此步骤，忽略此前提； **(使用主账号有权限过大的风险，不建议直接使用)** 2. 若使用子账号接入，需要首先登录控制台，开通接口访问权限；否则会报错**100013:AccessDenied错误;** 3. 开通接口权限步骤： 1. 使用火山引擎控制台主账号，登录控制台； 2. 点击用户头像进入访问控制模块，在用户模块点击管理按钮进入子账号权限管理界面； 3. 切换到权限TAB，点击添加权限按钮，在搜索栏输入“**TorchlightApiFullAccess**”权限，并选中确认； 4. 若有多个子账号访问平台，需对每个子账号进行相应权限配置。 4. 若使用火山引擎TOP网关接入，需要请求体整体长度不超过8M。 # 接口详情 ## 1、获取资讯内容流本接口用于根据资讯类型标签拉取最新热点资讯内容列表。 ### 请求结构 |通信协议 |HTTPS | |---|---| |请求方法（Method） |POST | |域名（Host） |mercury.volcengineapi.com | |Service |volc_torchlight_api | |Version |2025\-01\-01 | |Action |GetReportFeeds | |Region |cn\-north\-1 | |ContentType |application/json | ### URL |URL |* API Key接入：https://open.feedcoopapi.com/agent_api/agent/report_feed/get|\ | |* 基于火山引擎IAM的AK/SK鉴权：https://mercury.volcengineapi.com?Action=GetReportFeeds&Version=2025\-01\-01 | |---|---| |Method |POST | |Content\-Type |application/json | ### 请求体 **GetReportFeedsRequest** |**字段** |**类型** |**必需** |**说明** | |---|---|---|---| |BotId |String |是 |账号下一个有效的智能体id | |UserId |String |是 |用户身份标识（建议使用用户唯一id），客户自定义字符串格式，支持对相同Userid的用户下发资讯时消重。（免费试用状态无消重效果） | |Category|String|是 |获取的资讯内容分类，枚举如下：|\ | | | ||\ | | | |* default 综合|\ | | | |* finance 财经|\ | | | |* entertainment 娱乐|\ | | | |* car 汽车|\ | | | |* technology 科技|\ | | | |* sports 体育|\ | | | |* international 国际|\ | | | |* taiwan 台海|\ | | | |* military 军事 | |Limit |Number |否 |指定资讯分类的获取条数，默认为5，最大为10。（免费试用状态最多可获取5条） | ### 响应体 **GetReportFeedsResponse** |**字段** |**类型** |**必需** |**说明** | |---|---|---|---| |ReportArticles |Array[ReportArticle] |是 |返回分类下的资讯内容 | **ReportArticle** |**字段** |**类型** |**必需** |**说明** | |---|---|---|---| |Id |String |是 |资讯内容唯一ID | |Title |String |是 |资讯标题 | |Tags |Array[String] |是 |内容标签 | |KeyWords |Array[String] |是 |内容关键词 | |Abstract |String |是 |内容概述 | |Content |String |是 |内容详情 | |FollowUps |Array[String] |是 |内容追问词 | |CoverImages |Array[ArticleImage]|是 |内容封面图，目前仅提供一张|\ | | | |```JSON|\ | | | |[|\ | | | | {|\ | | | | "url": "https://xxx", // 封面图链接|\ | | | | "width": 123, // 封面图宽，不保证提供|\ | | | | "height": 123, // 封面图高，不保证提供|\ | | | | }|\ | | | |]|\ | | | |```|\ | | | | | |RelatedVideos |Array[ReportArticleVideo] |否 |相关视频 | |References |Array[ReportArticleReference] |否 |引用来源 | **ReportArticleReference** |**字段** |**类型** |**必需** |**说明** | |---|---|---|---| |Id |String |是 |引用内容唯一ID | |SourceType |String |是 |内容源 | |SiteName |String |否 |站点名，与SourceType存在映射，枚举场景优先使用SourceType | |Title |String |否 |标题 | |PublishTime |Number |否 |发布时间，UnixSecond时间戳|\ | | | |部分情况为0，例如部分搜索引擎结果等 | |Url |String |否 |落地页，部分搜索引擎结果没有URL | |CoverImages |Array[ArticleImage]|否 |封面图|\ | | | |```JSON|\ | | | |[|\ | | | | {|\ | | | | "url": "https://xxx", // 封面图链接|\ | | | | "width": 123, // 封面图宽，不保证提供|\ | | | | "height": 123, // 封面图高，不保证提供|\ | | | | }|\ | | | |]|\ | | | |```|\ | | | | | **ArticleImage** |**字段** |**类型** |**必需** |**说明** | |---|---|---|---| |Url |String |是 |图片链接 | |Width |Number |是 |图片宽度 | |Height |Number |是 |图片长度 | ### 请求示例 ```JSON { "BotId": "3577564", "UserId": "ge3fdsr532", "Category": "finance" } ``` ### 响应示例 ```JSON { "ResponseMetadata": { "RequestId": "202503201423272FC6E24546DE369A41AB", "Action": "GetReportFeeds", "Version": "2025-01-01", "Service": "volc_torchlight_api", "Region": "cn-north-1" }, "Result": { "ReportArticles": [ { "Title": "《藏海传》首播引争议", "Tags": [ "娱乐", "电视剧" ], "KeyWords": [ "藏海传", "肖战" ], "Abstract": "2024年，《藏海传》定位为新时代文化传承工程重点项目，2024年在央视八套开播。该剧获央视多个频道轮番宣传、国家广电总局重点推荐，首播收视率破2强势登顶。但网络差评如潮，其叙事悬念过度叠加、节奏前紧后松，角色塑造主次不分，主角藏海性格发展单薄，肖战演技在重场戏表现欠佳。此外，该剧为突出主角光环压制配角戏份，剧情既不够深也不够爽。", "Content": "2024年，《藏海传》定位为新时代文化传承工程重点项目，2024年在央视八套开播。该剧获央视多个频道轮番宣传、国家广电总局重点推荐，首播收视率破2强势登顶。但网络差评如潮，其叙事悬念过度叠加、节奏前紧后松，角色塑造主次不分，主角藏海性格发展单薄，肖战演技在重场戏表现欠佳。此外，该剧为突出主角光环压制配角戏份，剧情既不够深也不够爽。", "FollowUps": [ "藏海传", "肖战", "央视八套" ], "CoverImages": [ { "url": "https://xxx", "width": 123, "height": 123 } ], "References": [ { "Id": "7505995444908982836", "SourceType": "toutiao_article", "SiteName": "头条图文", "Title": "好家伙，央视力挺的谋权剧却差评一片，观众差评的理由也出奇一致", "PublishTime": 1747626303, "Url": "https://open.toutiao.com/a7505995444908982836/?biz_log=BHs6P647JA1gPJt3HgjLgKuekce6bbow66ChkYKpu8Ld7h15fRv21brnZc2Mp2RbLePSDy3kRc4AXMTShzodDhTf7UV5ThEs8nqtgyqEVpnJgHQL1LM8fyZFyKSDhrCkuVMZd5EJxUJcrmxsHA2N&group_id=7505995444908982836&label=torchlight&utm_source=agent_bot_5_default_content", "CoverImage": { "Url": "https://p3-open-sign.onewsimg.com/tos-cn-i-6w9my0ksvp/bc8734cd1c3244108fea9d7fd663ec0f~tplv-obj.jpeg?lk3s=2c3e0c70&scene=torchlight&x-expires=1810719925&x-signature=%2FeMfcwb5K4q2B0M3J9Uutmp%2BKoc%3D", "Width": 1588, "Height": 970 } } ], "RelatedVideos": [ { "Id": "m48SDqo5CdyRdT96bpoy922Zx1OHqMFu0OJIdNF7KZc", "SourceType": "douyin_video", "SiteName": "抖音视频", "Title": "藏海传优缺点都很明显，先吐槽再夸奖！", "CoverImage": { "Url": "https://p26-sign.douyinpic.com/tos-cn-p-0015/o8xBepXV9QMvVlGA74mA8KQBQVgy78gBEefczC~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1748854800&x-signature=y3Gcu6pYrSBXGeohhhPrd7wyHfQ%3D&from=327834062&s=PackSourceEnum_SEARCH&se=false&sc=cover&biz_tag=aweme_video&l=021747647925272fdbddc0100ffcd02ffffffff0000010416b6e3", "Width": 540, "Height": 960 }, "Url": "", "Width": 0, "Height": 0, "Duration": 0 } ] } ] } } ``` ## 2、查询资讯详情接口本接口用于根据资讯内容ID拉取详情。 ### 请求结构 |通信协议 |HTTPS | |---|---| |请求方法（Method） |POST | |域名（Host） |mercury.volcengineapi.com | |Service |volc_torchlight_api | |Version |2025\-01\-01 | |Action |GetReportArticle | |Region |cn\-north\-1 | |ContentType |application/json | ### URL |URL |* API Key接入：https://open.feedcoopapi.com/agent_api/agent/report_article/get|\ | |* 基于火山引擎IAM的AK/SK鉴权：https://mercury.volcengineapi.com?Action=GetReportArticle&Version=2025\-01\-01 | |---|---| |Method |POST | |Content\-Type |application/json | ### 请求体 **GetReportArticleRequest** |**字段** |**类型** |**必需** |**说明** | |---|---|---|---| |BotId |String |是 |账号下一个有效的智能体id | |UserId |String |是 |用户身份标识（建议使用用户唯一id），客户自定义字符串格式 | |ReportArticleId |String |是 |资讯id | ### 响应体 **GetReportArticleResponse** |**字段** |**类型** |**必需** |**说明** | |---|---|---|---| |Article |ReportArticle |是 |返回对应资讯内容 | ### 请求示例 ```JSON { "BotId": "3577564", "UserId": "ge3fdsr532", "ReportArticleId": "123" } ``` ### 响应示例 ```JSON { "ResponseMetadata": { "RequestId": "202503201423272FC6E24546DE369A41AB", "Action": "GetReportArticle", "Version": "2025-01-01", "Service": "volc_torchlight_api", "Region": "cn-north-1" }, "Result": { "Article": { "Title": "《藏海传》首播引争议", "Tags": [ "娱乐", "藏海传首播" ], "KeyWords": [ "藏海传", "肖战" ], "Abstract": "2024年，《藏海传》定位为新时代文化传承工程重点项目，2024年在央视八套开播。该剧获央视多个频道轮番宣传、国家广电总局重点推荐，首播收视率破2强势登顶。但网络差评如潮，其叙事悬念过度叠加、节奏前紧后松，角色塑造主次不分，主角藏海性格发展单薄，肖战演技在重场戏表现欠佳。此外，该剧为突出主角光环压制配角戏份，剧情既不够深也不够爽。", "Content": "2024年，《藏海传》定位为新时代文化传承工程重点项目，2024年在央视八套开播。该剧获央视多个频道轮番宣传、国家广电总局重点推荐，首播收视率破2强势登顶。但网络差评如潮，其叙事悬念过度叠加、节奏前紧后松，角色塑造主次不分，主角藏海性格发展单薄，肖战演技在重场戏表现欠佳。此外，该剧为突出主角光环压制配角戏份，剧情既不够深也不够爽。", "FollowUps": [ "藏海传", "肖战", "央视八套" ], "CoverImages": [ { "url": "https://xxx", "width": 123, "height": 123 } ], "References": [ { "Id": "7505995444908982836", "SourceType": "toutiao_article", "SiteName": "头条图文", "Title": "好家伙，央视力挺的谋权剧却差评一片，观众差评的理由也出奇一致", "PublishTime": 1747626303, "Url": "https://open.toutiao.com/a7505995444908982836/?biz_log=BHs6P647JA1gPJt3HgjLgKuekce6bbow66ChkYKpu8Ld7h15fRv21brnZc2Mp2RbLePSDy3kRc4AXMTShzodDhTf7UV5ThEs8nqtgyqEVpnJgHQL1LM8fyZFyKSDhrCkuVMZd5EJxUJcrmxsHA2N&group_id=7505995444908982836&label=torchlight&utm_source=agent_bot_5_default_content", "CoverImage": { "Url": "https://p3-open-sign.onewsimg.com/tos-cn-i-6w9my0ksvp/bc8734cd1c3244108fea9d7fd663ec0f~tplv-obj.jpeg?lk3s=2c3e0c70&scene=torchlight&x-expires=1810719925&x-signature=%2FeMfcwb5K4q2B0M3J9Uutmp%2BKoc%3D", "Width": 1588, "Height": 970 } } ], "RelatedVideos": [ { "Id": "m48SDqo5CdyRdT96bpoy922Zx1OHqMFu0OJIdNF7KZc", "SourceType": "douyin_video", "SiteName": "抖音视频", "Title": "藏海传优缺点都很明显，先吐槽再夸奖！", "CoverImage": { "Url": "https://p26-sign.douyinpic.com/tos-cn-p-0015/o8xBepXV9QMvVlGA74mA8KQBQVgy78gBEefczC~tplv-dy-resize-walign-adapt-aq:540:q75.jpeg?lk3s=138a59ce&x-expires=1748854800&x-signature=y3Gcu6pYrSBXGeohhhPrd7wyHfQ%3D&from=327834062&s=PackSourceEnum_SEARCH&se=false&sc=cover&biz_tag=aweme_video&l=021747647925272fdbddc0100ffcd02ffffffff0000010416b6e3", "Width": 540, "Height": 960 }, "Url": "", "Width": 0, "Height": 0, "Duration": 0 } ] } } } ```