음성 복제

POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-data

전체 URL:

https://fishaudio.org/api/open/v1/voices

음성 생성은 참조 오디오 및 FishAudio 생성 흐름을 사용합니다. Open API 경로는 공급자 재정의를 무시하므로 provider 필드를 보낼 필요가 없습니다.

요청 필드

필드	유형	필수	설명
`name`	문자열	예	음성 이름
`audioFiles`	파일[]	예	하나 이상의 참조 오디오 파일
`description`	문자열	아니요	음성 설명
`referenceText`	문자열	아니요	참조 오디오 대본
`visibility`	문자열	아니요	`private` 또는 `public`. 기본값: `private`
`languages`	문자열	아니요	JSON 문자열 배열(예: `'["zh","en"]'`)

지원되는 파일 확장자: aac, flac, m4a, mp3, mp4, mpeg, oga, ogg, opus, wav 및 webm. 각 파일은 최대 10MB까지 가능합니다.

다중 부분 경계를 수동으로 설정하지 마십시오. curl -F, 브라우저 FormData 또는 SDK를 사용하는 경우 클라이언트가 Content-Type를 생성하도록 합니다.

curl 예

curl -X POST "https://fishaudio.org/api/open/v1/voices" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -F "name=My cloned voice" \
  -F "description=Chinese narration voice" \
  -F "visibility=private" \
  -F 'languages=["zh"]' \
  -F "audioFiles=@/path/to/sample-1.mp3;type=audio/mpeg" \
  -F "audioFiles=@/path/to/sample-2.wav;type=audio/wav"

응답

{
  "voiceId": "voice_abc123",
  "title": "My cloned voice",
  "description": "Chinese narration voice",
  "createdAt": "2026-07-09T00:00:00.000Z"
}

반환된 voiceId를 저장한 다음 음성 생성 시 직접 전달합니다.

오류

상태	의미
`400`	누락된 필드, 지원되지 않는 파일 형식 또는 크기가 너무 큰 파일
`401`	API 키가 없거나 잘못되었습니다.
`403`	계정이 음성을 생성할 수 없습니다
`429`	음성 생성 요청이 너무 자주 발생함
`500`	서버에서 음성 생성 실패

음성 녹음 만들기 Open API 사용량은 현재 계정의 Open API 할당량 및 공급자 할당의 적용을 받습니다.

음성 복제

음성 복제

요청 필드

curl 예

응답

오류

이 페이지