보이스 나열

현재 API 키에 사용할 수 있는 공개 및 개인 음성을 나열합니다.

GET /api/open/v1/voices

전체 URL:

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

헤더

Authorization: Bearer FISHAUDIO_API_KEY

음성 나열은 읽기 전용입니다. 작업을 생성하거나 크레딧을 소비하지 않습니다.

쿼리 옵션

엔드포인트는 URL 쿼리 매개변수에서 선택적 필터를 읽습니다. 이를 생략하면 API는 공개 목소리의 첫 번째 페이지를 반환합니다.

필드	유형	필수	설명
`page`	정수	아니요	페이지 번호. 기본값: `1`
`pageSize`	정수	아니요	페이지당 항목 수입니다. 기본값: `20`, 최대값: `100`
`modelType`	문자열	아니요	`public`, `personal` 또는 `all`
`includePersonal`	부울	아니요	`true`인 경우 기본 모델 유형은 `all`
`language`	문자열	아니요	`zh` 또는 `en`과 같은 기본 언어 코드로 정확히 필터링
`supportsLanguage`	문자열	아니요	지정된 언어 코드를 지원하는 음성 필터링
`search`	문자열	아니요	음성 이름 또는 설명을 대소문자 구분 없이 검색

응답

{
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "items": [
    {
      "voiceId": "voice_123",
      "title": "Clara",
      "description": "",
      "created_at": "2026-07-09T00:00:00.000Z",
      "updated_at": "2026-07-09T00:00:00.000Z",
      "isPersonal": false
    }
  ]
}

TTS 요청에 items[].voiceId를 사용하세요.

빠른 테스트 음성

응답에서 음성을 선택하기 전에 TTS를 테스트하려면 다음 공개 시스템 음성 ID를 사용하십시오.

00a1b221-6137-4b73-ad62-b0cbce134167

프로덕션 음성을 선택할 준비가 되면 이를 items[].voiceId 값으로 바꾸십시오.

curl 예

curl "https://fishaudio.org/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

오류

상태	의미
`401`	API 키가 없거나 잘못되었습니다.
`403`	계정이 음성을 나열할 수 없습니다
`500`	음성 카탈로그 쿼리 실패

요청 미리보기

GET https://fishaudio.org/api/open/v1/voices?modelType=all&includePersonal=true&page=1&pageSize=20
Authorization: Bearer YOUR_API_KEY

보이스 나열

헤더

쿼리 옵션

응답

빠른 테스트 음성

curl 예

오류

요청 미리보기

이 페이지