오디오 샘플 업로드

음성 복제 또는 유사도 강화에 필요한 오디오 샘플을 업로드합니다.

오디오 샘플을 업로드하고 file_id를 가져옵니다. 음성 복제와 유사도를 높이는 보조 오디오는 서로 다른 purpose를 사용합니다.

POST/v1/minimax/files/upload

음성 복제 샘플 또는 유사도를 높이는 프롬프트 오디오를 업로드하고 이후 복제 API에 필요한 파일 ID를 가져옵니다.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

multipart/form-data

Multipart로 오디오 파일을 업로드합니다. 클라이언트 요청 라이브러리가 Content-Type의 boundary를 자동 생성하도록 해야 합니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

file*file

업로드할 MP3, M4A 또는 WAV 오디오입니다. 길이는 10초~5분이고 크기는 20MB를 넘을 수 없습니다.

형식binary

purpose?string

업로드 용도입니다. 음성 샘플은 voice_clone, 유사도를 높이는 프롬프트 오디오는 prompt_audio를 사용합니다.

기본값"voice_clone"

허용 값

"voice_clone"
"prompt_audio"

응답 본문

`application/json`

curl -X POST "https://example.com/v1/minimax/files/upload" \
  -F file="voice_sample.mp3" \
  -F purpose="voice_clone"

{
  "file": {
    "file_id": 2305843009214732,
    "bytes": 1048576,
    "created_at": 1717220000,
    "filename": "voice_sample.mp3",
    "purpose": "voice_clone"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

인증

요청 본문

응답 본문

200application/json

401application/json

`application/json`

`application/json`