获取文件图片 URL

最近更新时间:2025-07-22 14:17:32

我的收藏

接口定义

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

使用示例

import (
"context"
"log"
"github.com/tencent/vectordatabase-sdk-go/tcvectordb"
"github.com/tencent/vectordatabase-sdk-go/tcvectordb/api"
"github.com/tencent/vectordatabase-sdk-go/tcvectordb/api/ai_document_set"
)
var (
ctx = context.Background()
database = "go-sdk-test-db"
collectionName = "go-sdk-test-coll"
)
filename := "腾讯云向量数据库.pdf"
res, _ := client.GetImageUrl(ctx, database, collectionName, tcvectordb.GetImageUrlParams{
FileName: filename,
DocumentIds: []string{"1342412********9596", "1342412********9597"},
})
for _, docImages := range res.Images {
for _, docImage := range docImages {
log.Printf("docImage: %+v", docImage)
}
}

入参描述

参数
是否必选
参数含义
配置方法
database_name
指定查询的数据库名。
Database 命名要求如下:
只能使用英文字母,数字,下划线_、中划线-,并以英文字母开头。
长度要求:[1,128]。
collection_name
指定查询的集合名
Collection 命名要求如下:
只能使用英文字母,数字,下划线_、中划线-,并以英文字母开头。
长度要求:[1,128]。
document_ids
表示要查询的文档的所有 ID。
每个 ID 长度限制为[1,128]。支持批量查询,数组元素范围[1,20]。
文件上传成功之后,可使用 query 查询文件的 ID 信息。
res = client.query(
database_name='db-test',
collection_name='coll-file-test',
limit=100,
)
file_name
指定文件名称。

-

出参描述

"docImage": {
"DocumentId": 1342412866867179596,
"ImageName": "aa23511c-e722-4c2c-a74f-************.png",
"ImageUrl": "https://vecterdb************.cos.ap-guangzhou.myqcloud.com/embedding_file/vdb-********/db-test/coll-file-test-6/******************************************"
}
"docImage": {
"DocumentId": 1342412866867179597,
"ImageName": "aa23511c-e722-4c2c-a74f-************.png",
"ImageUrl": "https://vecterdb************.cos.ap-guangzhou.myqcloud.com/embedding_file/vdb-********/db-test/coll-file-test-6/******************************************"
}
参数名
参数含义
documentId
Document 的 ID 信息。
imageName
图片名。
imageUrl
图片 URL。