File

上传 File

上传文件到工作空间

POST

/api/v1/agentstudio/files

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/files' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --data '
{
  "file": "<string>"
}
'

{
  "id": "file_01JXH5K2M3N4",
  "filename": "sales.csv",
  "size": 102400,
  "status": "available",
  "created_at": "2026-07-20T10:00:00Z",
  "request_id": "req_xxx"
}

Authorizations

string

header

required

DashScope API Key

Body

multipart/form-data

file

要上传的文件，最大 10 MB

Response

200-application/json

string

文件 ID，格式 file_<ULID>

string

原始文件名

integer

文件大小（字节）

enum<string>

文件状态

Available options:checking,available,rejected,type_rejected

string

上传时间，ISO 8601

string

cURL

curl --request POST \
  --url 'https://{workspace_id}.{region}.maas.aliyuncs.com/api/v1/agentstudio/files' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: multipart/form-data' \
  --data '
{
  "file": "<string>"
}
'

{
  "id": "file_01JXH5K2M3N4",
  "filename": "sales.csv",
  "size": 102400,
  "status": "available",
  "created_at": "2026-07-20T10:00:00Z",
  "request_id": "req_xxx"
}