You need to enable JavaScript to run this app.
文档中心
市场洞察

市场洞察

复制全文
下载 pdf
接口列表
图片获取接口
复制全文
下载 pdf
图片获取接口

本文档介绍内容洞察数据的图片信息获取接口的调用方式。

概述

内容洞察的内容数据在客户场景使用时,客户业务会需要内容的图片信息,因此,内容洞察提供图片获取接口,客户侧可根据业务需要,通过内容ID,获取内容的图片地址信息。

备注:
接口调用前置操作,详见:调用指南

说明

图片链接有效时间6小时,过期后可重新调用接口获取新链接。


请求接口

基本信息

名称内容
接口地址/openapi/resource/image/cover
请求方式GET
是否需要鉴权是

请求参数

Header请求参数

字段类型是否必填说明
X-Insight-Biz-Namestring是业务名称,见「数据流管理」-API配置-「账号ID」
X-Insight-Access-Tokenstring是访问凭证,获取方式调用指南
Content-Typestring是'application/json'

Query请求参数

字段类型是否必填说明
post_idstring必填,post_id/origin_id二选一,post_id在首次获取内容中同步提供发文ID
origin_idstring抖音原始ID

返回参数

字段类型说明
statusint0为成功
messagestring返回错误信息
datamain_urlstring图片访问链接
backup_urlstring图片访问链接[备用]

调用示例

请求示例

GET /openapi/resource/image/cover?post_id=<xxxxxxxx>

header:
X-Insight-Biz-Name: $biz_name
X-Insight-Access-Token: $token
Content-Type: application/json
curl --location 'https://insight.volcengineapi.com/openapi/resource/image/cover?post_id=$post_id' \
--header 'X-Insight-Access-Token: $token' \
--header 'X-Insight-Biz-Name: $biz_name' \
--header 'Content-Type: application/json'

返回示例

{
    "status":  0,
    "message": "succeed",
    "data": {
        "main_url":   "", // 图片访问链接
        "backup_url": "" // 图片访问链接(备用)
    }
}

错误码

  • 公共错误码:您可访问错误代码,获取更多错误码信息。

最近更新时间:2026.09.02 11:20:23
这个页面对您有帮助吗?
有用
有用
无用
无用