返回文件元数据(不含内容),常用于确认上传后的安全审核 status 是否已转为 available。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
GET /files/{file_id}
返回文件元数据(filename、size_bytes、mime_type、created_at、status),不含内容。scope 字段仅在会话沙箱内部拷贝上返回。
状态说明
status 表示安全审核结果,取值:available(审核通过,可挂载到会话)、checking(审核中)、rejected(内容未通过审核)、type_rejected(文件类型不支持)。仅 available 状态的文件可被挂载到会话或作为消息内容引用。
请求示例
curl "$AGENTSTUDIO_URL/files/file_xxx" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"
file = client.files.retrieve("file_xxx")
print(file.filename, file.size_bytes, file.mime_type)
import os
import dashscope
client = dashscope.Client(api_key=os.getenv('DASHSCOPE_API_KEY'))
# 查询文件信息(返回文件元数据,不含内容)
result = client.files.get('file-xxx')
print(result.file_id, result.name, result.size)
AgentStudioFile f = client.files().retrieve("file_xxx");
System.out.println(f.getFilename() + " " + f.getSizeBytes());
响应字段响应为 File 对象。字段如下: id 文件 ID,格式如 type 固定为 filename 文件名 mime_type 服务端检测的 MIME 类型 size_bytes 文件大小,单位字节 downloadable 是否支持下载,当前接口直传与会话沙箱拷贝均为 status 安全审核状态: scope 仅会话沙箱内部拷贝返回,结构 created_at 上传时间,ISO 8601 requestId 本次请求的唯一标识 | 响应示例 |
该文章对您有帮助吗?