API 레퍼런스
음성 목록
TTS에 사용 가능한 음성 조회
POST
/api/v1/voices/
인증된 사용자가 텍스트 음성 변환 API에서 사용할 수 있는 모든 음성 목록을 반환합니다.
인증
Authorization 헤더에 Bearer YOUR_API_KEY 형식으로 API 키를 포함하세요.
요청 본문
| 매개변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
| language | 선택 | string | 음성 이름과 배지 값의 언어입니다. 예: ar, fr, zh-hans(URL의 ?language=로도 지정 가능). 해당 언어의 텍스트가 없는 음성은 영어로 표시되며, 코드가 없거나 지원되지 않는 경우에도 영어가 사용됩니다. 사용된 언어는 응답 헤더 Content-Language에 표시됩니다. |
| engine | 선택 | string | API 키는 자신의 유형(키를 만들 때 선택한 표준 또는 고급)의 음성만 목록에 보여 줍니다. engine을 보내는 경우 키의 유형과 같아야 합니다. |
응답
| 필드 | 유형 | 설명 |
|---|---|---|
| voice_id | 정수 (integer) | 고유 음성 식별자 |
| voice_name | string | 음성 표시 이름 |
| voice_sample_url | string | 음성 샘플 오디오 파일 URL |
| voice_fees | float | 이 음성 사용 요금(0은 무료를 의미) |
| voice_badges | object | 음성에 대한 추가 메타데이터(예: 언어, 성별, 연령, 사용 사례) |
| voice_engine | string | standard 또는 advanced. 일반 엔진 음성은 mode를 사용하며, 고급 엔진 음성은 context, setting, style, pace를 사용합니다. 참조: 엔진 및 모드. |
예시
curl "https://moknah.io/api/v1/voices/" \
-H "Authorization: Bearer YOUR_API_KEY"
import requests
response = requests.post(
"https://moknah.io/api/v1/voices/",
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
voices = response.json()
for voice in voices:
print(voice["voice_name"], voice["voice_sample_url"])
const response = await fetch(
'https://moknah.io/api/v1/voices/',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const voices = await response.json();
console.log(voices);
응답 예시
[
{
"voice_id": 1328,
"voice_name": "Adnan",
"voice_sample_url": "https://storage.moknah.io/media/voice_samples/Adnan.mp3",
"voice_fees": 0.0,
"voice_badges": {
"language": "Arabic",
"gender": "Male",
"age": "Young Adult",
"use_case": "Documentary, Audiobook, Article",
},
"voice_engine": "standard"
}
]
API 지원
API 관련 질문이나 문제는 다음 주소로 문의해 주세요: api@moknah.io.