j9九游会登录/ 智能体平台 agentarts/ api参考/ api/ 知识库/ 获取知识库检索图片 - openqueryimage
更新时间：2026-02-06 gmt 08:00
查看pdf

获取知识库检索图片 -j9九游会登录

功能介绍

通过图片id获取知识库检索图片。

适用场景：

  • 当知识库检索接口的返回内容中包含知识库图片标签{ki|image_id}时，可通过解析标签中的image_id调用本接口获取对应图片。

  • 当知识库检索接口返回image_ids字段列表时，可使用其中任意一个image_id调用本接口，查询或下载对应的图片文件流。

  • 当智能体应用、工作流应用返回内容中包含![img](https://versatile_knowledge_img_url/image_id)时，可通过标签中的image_id调用本接口获取对应图片。

图片的有效期为7天。

调用方法

请参见如何调用api。

uri

get /v2/{project_id}/knowledge-bases/images/{image_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

string

参数解释：

当前租户项目id。

获取方法请参考获取项目id。

约束限制：

不涉及。

取值范围：

由英文，数字，“-”，“_”组成，不超过64位字符。

默认取值：

不涉及。

image_id

是

string

参数解释：

图片id。

获取方式：

  1. 从智能体应用、工作流应用或知识库检索接口返回文本中的图片标签{ki|image_id}中解析获取。

  2. 从知识库检索接口返回的image_ids字段列表中选择任意一个image_id。

约束限制：

有效期为7天。

取值范围：

由英文、数字、“-”、“_”组成，长度不超过100位字符。

默认取值：

不涉及。

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

是

string

参数解释：

用户token。通过调用iam服务获取用户token接口获取（响应消息头中x-subject-token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应body参数

参数

参数类型

描述

-

file

图片文件流。

请求示例

  • 获取知识库检索图片。

    {
  "method" : "get",
  "url" : "https://api.example.com/v2/{project_id}/knowledge-bases/images/{image_id}",
  "headers" : {
    "x-auth-token" : "test-token******"
  }
}

响应示例

状态码：200

图片文件流。

状态码

状态码

描述

200

图片文件流。

错误码

请参见错误码。

父主题： 知识库

相关文档

网站地图