File Management (File Management)

File upload and management interface for multimodal interactions. Supports uploading images, audio, and other files.

API Endpoints

POST/files/upload

Upload file

GET/files/retrieve

Retrieve file information

DELETE/files/delete

Delete file

Request Parameters

ParameterTypeRequiredDescription
filefileRequiredFile to upload (multipart/form-data)
purposestringRequiredFile purpose: voice_clone, file_extract, etc.

Request Example

Request Example
// multipart/form-data 请求
POST /v1/files/upload
Content-Type: multipart/form-data

file: [二进制文件数据]
purpose: "voice_clone"

Response Example

Response Example
{
  "file_id": "file_xxxxx",
  "filename": "sample.mp3",
  "bytes": 1024000,
  "purpose": "voice_clone",
  "created_at": 1234567890
}

Code Examples

import requests

url = "https://your-proxy-domain.com/v1/files/upload"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}
files = {
    "file": open("sample.mp3", "rb")
}
data = {
    "purpose": "voice_clone"
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())