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 varies by purpose: 150 MB for file-extract, 500 MB for batch, and 300 MB for fine-tune.
- The total storage quota for active (not deleted) files is 100 GB.
- The total number of active (not deleted) files is limited to 10,000.
Upload a file
Request example
Request parameters
Parameter | Type | In | 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 | No |
If you do not specify purpose, the file can still be uploaded successfully. We recommend that you explicitly specify purpose to manage files by usage later. | ||||||||
descriptions | file stream | multipart/form-data | No | A description of the file. |
Response example
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, which can be used in 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.
Response parameters
Parameter | Type | Description |
|---|---|---|
code | string | The error code. |
request_id | string | The unique ID of the request. |
message | string | The error message. |