cURL
curl --request POST \
--url https://api.z.ai/api/paas/v4/files \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form purpose=user_data \
--form file='@example-file'import requests
url = "https://api.z.ai/api/paas/v4/files"
files = { "file": ("example-file", open("example-file", "rb")) }
payload = { "purpose": "user_data" }
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('purpose', 'user_data');
form.append('file', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://api.z.ai/api/paas/v4/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.z.ai/api/paas/v4/files")
.header("Authorization", "Bearer <token>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"purpose\"\r\n\r\nuser_data\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();{
"id": "<string>",
"object": "<string>",
"bytes": 123,
"filename": "<string>",
"purpose": "<string>",
"created_at": 123
}{
"code": 123,
"message": "<string>"
}Agent API
File Upload
This API is designed for uploading auxiliary files (such as glossaries, terminology lists) to support the translation service. It allows users to upload reference materials that can enhance translation accuracy and consistency.
POST
/
paas
/
v4
/
files
cURL
curl --request POST \
--url https://api.z.ai/api/paas/v4/files \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form purpose=user_data \
--form file='@example-file'import requests
url = "https://api.z.ai/api/paas/v4/files"
files = { "file": ("example-file", open("example-file", "rb")) }
payload = { "purpose": "user_data" }
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('purpose', 'user_data');
form.append('file', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://api.z.ai/api/paas/v4/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.z.ai/api/paas/v4/files")
.header("Authorization", "Bearer <token>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"purpose\"\r\n\r\nuser_data\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();{
"id": "<string>",
"object": "<string>",
"bytes": 123,
"filename": "<string>",
"purpose": "<string>",
"created_at": 123
}{
"code": 123,
"message": "<string>"
}File Limitations
- Maximum 100 files
- Maximum 100MB per file
- Files retained for 180 days
Authorizations
Body
multipart/form-data
Was this page helpful?