● ai3.aiinplanet.com — Voice API

음성 만들기(TTS)·받아쓰기(ASR) — OpenAI Audio API 호환

서버 구성

ai1·ai2·ai3·ai4는 한 묶음으로 관리되는 같은 API입니다. 받아쓰기는 ai1이, 음성 만들기는 ai2·ai3·ai4가 맡습니다. 음성 서버(ai2·ai3·ai4)로 보낸 받아쓰기 요청은 ai1로 자동으로 넘어가므로, ai2·ai3·ai4 중 하나만 Base URL로 써도 음성 만들기와 받아쓰기를 모두 쓸 수 있습니다.

주소맡는 일
https://ai1.aiinplanet.com받아쓰기(ASR) 전용 — /v1/audio/transcriptions
https://ai2.aiinplanet.com음성 만들기(TTS) + 받아쓰기(ai1로 전달)
https://ai3.aiinplanet.com음성 만들기(TTS) + 받아쓰기(ai1로 전달)
https://ai4.aiinplanet.com음성 만들기(TTS) + 받아쓰기(ai1로 전달)
https://ai.aiinplanet.comLLM(Gemma) — 별도 안내
Base URL
https://ai3.aiinplanet.com
호환 규격
OpenAI Audio API 호환 (/v1/audio/speech, /v1/audio/transcriptions)
인증
Authorization: Bearer <API_KEY> (키는 별도 안내)
출력
오디오 — mp3(기본) / wav / opus / pcm
API 키는 보안을 위해 이 공개 문서에 표시하지 않습니다. 예제의 YOUR_API_KEY 자리에 발급받은 키(sk-aiin-…)를 넣어 사용하세요.

엔드포인트

메서드경로설명인증
POST/v1/audio/speech글 → 음성 (메인)Bearer
GET/v1/audio/voices?model=newvoice목소리 목록 (language, group으로 거르기) — 이 페이지 아래 '목소리 찾기'에서도 볼 수 있음Bearer
POST/v1/audio/transcriptions음성 → 글 (multipart file)Bearer
POST/v1/audio/clone올린 기준 음성의 목소리로 말하기 (multipart: input, reference_audio, ref_text, model=newvoice)Bearer
GET/v1/models모델 목록공개
POST/mcpAI 에이전트용 MCP 서버 (아래 'MCP 연결')Bearer

MCP 연결 (AI 에이전트)

Claude 등 MCP 클라이언트가 목소리를 찾고 음성을 만들 수 있습니다. 인증은 HTTP 헤더의 API 키로만 합니다.

도구설명
list_voices목소리 목록 — 언어·성별·나이·묶음·감정·검색어로 거르기
generate_speech글 → 음성. 24시간 유효한 다운로드 URL 반환 (mp3·wav·opus)
get_guide사용 가이드 (overview · voices · text · api)
claude mcp add --transport http aiin-voice https://tts.aiinplanet.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

모델

model용도목소리
newvoice기본. 30개 언어, 자연스러운 대화체, 한국어 감정(기쁨·슬픔·화남)목소리 목록의 id (예: zs_haneul, en_lily, es_lg_fy)
newvoice-rt빠른 응답(실시간 대화용). 첫 문장이 더 빨리 나옵니다newvoice와 같음
tts-1, tts-1-hdOpenAI 호환 이름 → newvoicealloy echo fable onyx nova shimmer 및 목록의 모든 id
styletts2한국어 아나운서 16명aiin_* (예: aiin_lee_jiwoo)
vocos-lowadv이전 한국어 엔진(호환용)—
qwen3-asr받아쓰기(ASR), 30개 언어—

newvoice와 styletts2는 같은 aiin_* 이름을 다른 목소리로 씁니다. newvoice의 aiin_*는 AI 튜터 선생님 목소리입니다.

음성 만들기 — POST /v1/audio/speech

필드설명
modelnewvoice (권장) · newvoice-rt · tts-1 · styletts2
input읽을 글 (최대 5,000자). 한국어 숫자·단위·영문은 자동으로 읽기 좋게 바꿉니다
voice목소리 id (아래 목소리 찾기)
language선택. 생략하면 글자로 정합니다(한국어 목소리가 영어 문장을 받으면 영어로 읽음)
emotion선택. happy · sad · angry — 목록에서 emotions가 있는 목소리만
speed0.5 ~ 2.0 (기본 1.0)
response_formatmp3(기본) · wav · opus · pcm

빠른 시작

언어 (30개)

목소리 찾기

불러오는 중…
id이름언어성별·나이감정설명

오류

코드뜻
400요청 형식 오류(빈 글, 모르는 목소리 등) — {"error","message"}
401키가 없거나 틀림
429분당 요청 한도 초과
502 / 503음성 서버가 잠시 응답하지 않음 — 잠시 뒤 다시, 또는 다른 주소(ai2·ai3·ai4)