Upload a file-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

Upload files to the Model Studio platform. You can upload multiple files at once and reuse them across different jobs.

Usage limits

The following usage limits apply when you use this service:

The maximum size of a single file is 1 GB.
The total storage quota for active (not deleted) files is 5 GB.
The total number of active (not deleted) files is limited to 100.

For OpenAI-compatible calls, see OpenAI Compatibility - File.

Upload a file

POST https://dashscope.aliyuncs.com/api/v1/files
Content-type: multipart/form-data

Request example

curl --request POST "https://dashscope.aliyuncs.com/api/v1/files" \
  --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
  --form 'files=@"/path/to/your/file1.jsonl"' \
  --form 'purpose="fine-tune"'\
  --form 'descriptions="a sample fine-tune data file for qwen"' \
  --form 'files=@"/path/to/your/file2.jsonl"' \
  --form 'purpose="fine-tune"'\
  --form 'descriptions="a sample fine-tune data file for qwen"'

Request parameters

Parameter

Type

Required

Description

files

file stream

multipart/form-data

Yes

The file to upload. You can upload multiple files in one request.

purpose

string

multipart/form-data

Yes

Value	Purpose
`fine-tune`	Use the returned `file_id` to create a fine-tuning job. For fine-tuning video or image generation models, upload the training data as a .zip file (≤ 1 GB).
`file-extract`	Use the returned `file_id` for content analysis with long context (Qwen-Long).
`batch`	Use the returned `file_id` to create a batch job.

descriptions

string

multipart/form-data

A description of the file.

Response example

{
    "request_id": "xxx",
    "data": {
        "uploaded_files": [
            {
                "file_id": "9G2EaQtq7p1fw7oRhYXdHTtDFYAMVQSh95432B38CAB211EDB8F952C2E8001733",
                "name": "test.txt"
            }
        ],
        "failed_uploads": [
            {
                "name": "test1.jpg",
                "code": "BadRequest.TooLarge",
                "message": "Out of space, <839> B of <1024> B storage space has been used."
            },
            {
                "name": "test2.jpg",
                "code": "BadRequest.TooMany",
                "message": "Out of number, <10> of <10> files has been uploaded."
            }
        ]
    }
}

Response parameters

Parameter	Type	Description
data.failed_uploads	array	Information about files that failed to upload.
data.uploaded_files	array	Information about successfully uploaded files.
data.uploaded_files.$.file_id	string	The file ID. You can use this ID with the Retrieve file details and Delete file APIs.
data.uploaded_files.$.name	string	The file name.
request_id	string	The unique ID of the request.

Error responses

Response example

A non-200 HTTP status code indicates that the request failed. The following is an example of an error response.

{
    "request_id": "8f25f57c-5cc0-9881-9c83-62bc173dc9ad",
    "code": "InvalidParameter",
    "message": "File not found."
}

Response parameters

Parameter	Type	Description
code	string	The error code.
request_id	string	The unique ID of the request.
message	string	The error message.