文件管理 (File Management)

文件上传和管理接口，用于多模态交互。支持上传图片、音频等文件。

API 端点

POST/files/upload

上传文件

GET/files/retrieve

获取文件信息

DELETE/files/delete

删除文件

请求参数

参数名类型必填说明
filefile必填要上传的文件（multipart/form-data）
purposestring必填文件用途：voice_clone, file_extract 等

请求示例

请求示例
// multipart/form-data 请求
POST /v1/files/upload
Content-Type: multipart/form-data

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

响应示例

响应示例
{
  "file_id": "file_xxxxx",
  "filename": "sample.mp3",
  "bytes": 1024000,
  "purpose": "voice_clone",
  "created_at": 1234567890
}

代码示例

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())