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

上传 File

上传文件到业务空间

POST
/api/v1/agentstudio/files
cURL
curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/files' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --data '
{
  "file": "<string>"
}
'
{
  "id": "file_xxx",
  "type": "file",
  "filename": "sales_2025.csv",
  "downloadable": false,
  "mime_type": "text/csv",
  "size_bytes": 524288,
  "status": "checking",
  "created_at": "2026-06-16T14:51:39+08:00",
  "requestId": "xxx"
}
filename 自动从表单部分获取，mime_type 由服务端检测。上传后进入安全审核，available 状态才可挂载或作为消息内容。

上传限制

维度限制
单文件大小10 MB
业务空间文件总容量100 GB
保存时效30 天，超期可能被自动清理，需长期保留请定期重新上传

作用域

普通上传返回的文件无 scope 字段（默认业务空间共享）。文件被挂载到会话沙箱时，服务端做内部拷贝并生成新的 file_id，该副本元数据带 scope: {"type": "session", "id": "sesn_..."}，仅对应会话可见。

鉴权

​
string
header
必填

DashScope API Key

请求体

multipart/form-data
​
file
必填

要上传的文件，最大 10 MB。filename 自动从表单部分获取，mime_type 由服务端检测

响应

200-application/json
​
string

文件 ID，格式 file_<24位字母数字>（如 file_maznwes8t9rsysg5r5enkvpr）

​
string

固定为 file

​
string

文件名（自上传时表单部分解析得到）

​
boolean

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

​
string

服务端检测的 MIME 类型

​
integer

文件大小，单位字节

​
enum<string>

安全审核状态：available（通过，可挂载）/ checking（审核中）/ rejected（内容未通过）/ type_rejected（类型不支持）。新上传文件默认 checking

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

上传时间，ISO 8601

​
string

本次请求的唯一标识。Python SDK 中对应属性为 request_id