文件 API
上传
上传文件
/v1/files
将文件上传到 xAI 存储，并返回文件元数据。凡是接受 `file_id` 的位置都可以通过 ID 引用文件（例如聊天附件）。文件大小上限为 50 MB。文件会一直保留，直到你删除文件，或在上传时设置的 `expires_after` 到期。
请求体
filestring（string，必填）— 要上传的文件。multipart `Content-Disposition: filename=` 请求头中的文件名会记录为文件的 `filename`。
响应体
bytesinteger（integer，必填）— 文件大小，单位为字节。
created_atinteger（integer，必填）— 文件创建时间的 Unix 时间戳（单位为秒）。
filenamestring（string，必填）— 文件名。
idstring（string，必填）— 文件标识符，可用于其他 API 请求。
objectstring（string，必填）：对象类型，始终为 `file`。仅为兼容性而包含。
purposestring（string）：上传文件的预期用途。仅为兼容 OAI 而包含。
No parameters.{
"id": "file_a128090d-f0c9-4873-bd84-e499777e7417",
"object": "file",
"bytes": 12345,
"created_at": 1762345678,
"expires_at": 1762432078,
"filename": "document.pdf",
"purpose": ""
}No parameters.No response.No parameters.No response.最后更新：2026 年 4 月 28 日