跳转到主要内容
千问AI平台 home page
文档
File

获取 File

获取文件元数据

GET
/api/v1/agentstudio/files/{file_id}
cURL
curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/files/{file_id}' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "id": "file_xxx",
  "type": "file",
  "filename": "sales_2025.csv",
  "downloadable": false,
  "mime_type": "text/csv",
  "size_bytes": 524288,
  "status": "available",
  "created_at": "2026-06-16T14:51:39+08:00",
  "requestId": "xxx"
}
返回 filename、size_bytes、mime_type、created_at、status 等元数据，不含内容，常用于确认上传后的安全审核 status 是否已转为 available。scope 字段仅会话沙箱内部拷贝返回。

文件状态

status 表示安全审核结果，仅 available 状态的文件可被挂载到会话或作为消息内容引用。
status说明
available审核通过，可挂载或作为消息内容
checking审核中
rejected内容未通过审核
type_rejected文件类型不支持

鉴权

​
string
header
必填

DashScope API Key

路径参数

​
string
必填

文件 ID

响应

200-application/json
​
string

文件 ID，格式如 file_kyu8k8lut4d4x47ii7qf92yk

​
string

固定为 file

​
string

文件名

​
boolean

是否支持下载，当前接口直传与会话沙箱拷贝均为 false

​
string

服务端检测的 MIME 类型

​
integer

文件大小，单位字节

​
enum<string>

安全审核状态：available / checking / rejected / type_rejected

可选值：available,checking,rejected,type_rejected
​
object

仅会话沙箱内部拷贝返回，结构 {"type": "session", "id": "sesn_..."}；普通上传文件不返回该字段

​
string

上传时间，ISO 8601

​
string

本次请求的唯一标识