获取文件图片 URL

最近更新时间:2025-03-04 20:25:12

我的收藏

接口定义

GetImageUrl() 接口用于在使用 AI 套件上传 PDF 类型的文件后,获取图片 URL 地址列表。
说明:
当在数据库的 Collection 中上传 PDF 文件时,系统会提取 PDF 中的图片信息,并将这些信息以 Key 列表的形式存储。在检索出的原始文本块中,图片的位置会以 {key} 的形式进行占位。通过调用接口 GetImageUrl(),可以获取到与这些 Key 一一对应的图片 URL 地址列表。利用这种映射关系,可以将原始 PDF 文档的内容恢复并以 HTML 格式进行展示。
public GetImageUrlRes GetImageUrl(String database, String collection, GetImageUrlParam param)

使用示例

GetImageUrlRes getImageUrlRes = client.GetImageUrl("db-test", "coll-file-test",
GetImageUrlParam.newBuilder().setFileName("tcvdb.pdf")
// 指定具体的文件 ID
.setDocumentIds(Arrays.asList("1340988975862403135"))
.build());
System.out.println("get image url res:");
System.out.println(JsonUtils.toJsonString(getImageUrlRes.getImages()));

入参描述

参数名
子参数
是否必选
参数含义

database
-
指定查询的数据库名。
Database 命名要求如下:
只能使用英文字母,数字,下划线_、中划线-,并以英文字母开头。
长度要求:[1,128]。
collection
-
指定查询的集合名
Collection 命名要求如下:
只能使用英文字母,数字,下划线_、中划线-,并以英文字母开头。
长度要求:[1,128]。
GetImageUrlParam
setDocumentIds
表示要查询的文档的所有 ID。
每个 ID 长度限制为[1,128]。支持批量查询,数组元素范围[1,20]。
文件上传成功之后,可使用 query 查询文件的 ID 信息。
setFileName
指定文件名称。

-

输出信息

[
[
{
"documentId": "1340988975862403135",
"imageName": "ea97227d-1b12-4d35-8b67-************.png",
"imageUrl": "https://vecterdb************.cos.ap-guangzhou.myqcloud.com/embedding_file/vdb-********/db-test/coll-file-test-6/******************************************"
},
{
"documentId": "1340988975862403135",
"imageName": "a5daca6f-a27e-4b35-89f5-************.png",
"imageUrl": "https://vecterdb************.cos.ap-guangzhou.myqcloud.com/embedding_file/vdb-********/db-test/coll-file-test-6/******************************************"
}
]
]
参数名
参数含义
documentId
Document 的 ID 信息。
imageName
图片名。
imageUrl
图片 URL。