파일 관리 (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())