接口说明

通过该接口，您可根据数据集 ID 和数据主键，获取存储在 AI 搜索平台中的底层媒体资源（如音视频、图片）临时安全访问链接，可直接用于前端展示或下载。

重点用途：

AI 搜索平台所创建好的搜索应用，在通过 搜索 API 调用时，结果返回的图片、音视频结果 URL 均为预签名链接，具有一定的有效期（24 小时）。

若您的应用在本地持久化存储了这些 URL，后续访问时可能因过期而失效。在这种情况下，可调用本接口，传入对应的数据集 ID 和数据记录主键，即可获取该资源的最新有效访问链接。

请求参数

字段名称	字段类型	字段详情
body	object	请求 Body。示例值： `{` `"datasetId": 730,` `"primaryKey": "01KQCJBPM9JVDTXWV50G2AK"` `}`
datasetId	string	数据集 ID，可在控制台数据集列表中查看。示例值：`730`
primaryKey	string	数据集中的数据记录主键值。示例值：`01KQCJBPM9JVDTXWV50G2AK`

响应参数

字段名称	字段类型	字段详情
code	integer<int32>	业务状态码。200 表示请求成功，其他值表示异常，详见错误码示例值：`200`
message	string	状态描述。成功时为 "success"，失败时为具体的错误信息。示例值：`success`
data	object	业务数据主体
url	string	带有签名和过期时间的 OSS 临时访问链接（24 小时内有效），可直接用于前端展示或下载示例值：`https://maas-ai-search-center-raw.oss-cn-hangzhou.aliyun.com/sample.mp4...`
requestId	string	请求唯一标识，用于问题排查示例值：`1a0f40dd17774641794394269ec0e9`

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "url": "https://maas-ai-search-center-raw.oss-cn-hangzhou.aliyuncs.com/.../sample.mp4..."
  },
  "requestId": "1a0f40da17774667074596639ec2b6"
}

错误码

错误码	message	说明	建议处理方式
400	datasetId: must not be null	请求参数不完整或格式错误。例如，缺少必需的 `datasetId` 参数。	检查您的请求，确保所有必填参数都已提供且格式正确。
403	Access denied	访问被拒绝，通常是由于身份验证失败或权限不足。	检查您的 Access Key 或其他认证信息是否正确，并确认您有操作该资源的权限。
404	Dataset not found	指定的数据集不存在。	请检查请求中的 `datasetId` 是否正确。
404	Resource not found	指定主键值在目标数据集内无对应记录。	请检查请求中指定的资源 primaryKey 是否正确。
404	Resource file not found	指定主键值存在，但 rawFilePath 字段为空、或 OSS 预签名 URL 生成为空（文件异常或被删除），指定的资源文件不存在。	请检查请求中指定的文件是否正确存储，请检查存储资源是否正常。
500	Internal server error	服务器内部发生未知错误。	请稍后重试。如果问题持续存在，请联系技术支持。