Gestión de archivos (File Management)

Interfaz de carga y gestión de archivos para interacciones multimodales. Soporta la carga de imágenes, audio y otros archivos.

Endpoints de la API

POST/files/upload

Cargar archivo

GET/files/retrieve

Obtener información del archivo

DELETE/files/delete

Eliminar archivo

Parámetros de solicitud

ParámetroTipoObligatorioDescripción
filefileObligatorioArchivo a cargar (multipart/form-data)
purposestringObligatorioPropósito del archivo: voice_clone, file_extract, etc.

Ejemplo de solicitud

Ejemplo de solicitud
// multipart/form-data 请求
POST /v1/files/upload
Content-Type: multipart/form-data

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

Ejemplo de respuesta

Ejemplo de respuesta
{
  "file_id": "file_xxxxx",
  "filename": "sample.mp3",
  "bytes": 1024000,
  "purpose": "voice_clone",
  "created_at": 1234567890
}

Ejemplos de código

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