ai3.aiinplanet.com ●

모델 (요청의 model 값으로 백엔드 분기)

보이스 전체 목록: GET /v1/audio/voices?model=kokoro 또는 ?model=styletts2

엔드포인트

빠른 시작

복사# 영어 (Kokoro) → speech.wav
curl https://ai3.aiinplanet.com/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kokoro",
    "input": "Hello, this is a test.",
    "voice": "af_bella",
    "response_format": "wav"
  }' --output speech.wav

복사from openai import OpenAI

client = OpenAI(
    base_url="https://ai3.aiinplanet.com/v1",
    api_key="YOUR_API_KEY",
)

resp = client.audio.speech.create(
    model="kokoro",
    voice="af_bella",
    input="Hello, this is a test.",
)
resp.stream_to_file("speech.wav")

복사# 한국어 (StyleTTS2) — model=styletts2, 한국어 보이스
curl https://ai3.aiinplanet.com/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "styletts2",
    "input": "안녕하세요. 음성 합성 테스트입니다.",
    "voice": "aiin_lee_jiwoo",
    "language": "ko"
  }' --output korean.wav

복사# 스트리밍 — stream:true, 받는 즉시 재생 (첫 소리 ~0.1초)
curl -N https://ai3.aiinplanet.com/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "styletts2",
    "input": "첫 문장입니다. 두 번째 문장이 이어서 재생됩니다.",
    "voice": "aiin_yoon_minseo",
    "stream": true
  }' | ffplay -nodisp -autoexit -

요청 파라미터 POST /v1/audio/speech

자동 한국어 전처리 NEW

한국어 엔진(styletts2·vocos-lowadv) 호출 시 입력 텍스트가 발음 정규화를 자동으로 거칩니다(설정 불필요). 응답 헤더 X-Aiin-Preprocess: 1로 확인됩니다.

긴 본문은 문장 단위로 나눠 합성 후 이어붙여 반환합니다(엔진 최적 길이 유지). 시·살·시간만 고유어로 읽습니다(두 시·쉰 살). kokoro(영어)는 전처리 대상이 아닙니다.

스트리밍 재생 NEW

용도에 따라 두 가지로 받습니다. 파일로 저장·후처리하려면 기본(whole), 대기 없이 바로 재생하려면 스트리밍을 쓰세요.

스트리밍은 문장별로 즉시 전송돼 첫 오디오가 ~0.1초에 도착합니다(전체 완성 대기 없음). 응답 헤더 X-Aiin-Stream: 1. 스트리밍 응답을 파일로 저장하면 재생은 되지만 헤더의 총 길이가 미확정이라, 정확한 길이의 파일이 필요하면 기본(whole) 모드를 쓰세요.

출력 형식 & 전송 방식 — API로 선택 NEW

response_format(형식)과 stream(전송)을 자유롭게 조합해 요청하세요. 재생 목적이면 스트리밍, 저장·대역폭 절약이면 mp3/opus를 권장합니다.

복사# 스트리밍 + mp3 — 재생하며 받기(첫음성 즉시 + 작은 용량)
curl -N https://ai3.aiinplanet.com/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"styletts2","input":"안녕하세요.","voice":"aiin_kim_seoyeon","language":"ko","stream":true,"response_format":"mp3"}' --output out.mp3

# 파일 저장 + opus — 최소 용량
curl https://ai3.aiinplanet.com/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vocos-lowadv","input":"제로샷 음성입니다.","voice":"aiin_yoon_minseo","language":"ko","response_format":"opus"}' --output out.opus

스트리밍에서도 response_format이 그대로 적용됩니다(mp3/opus 청크 실시간 인코딩). 4개 서버(ai1~ai4) 모두 동일하게 동작합니다.

제로샷 클론 NEW POST /v1/audio/clone

참조 음성(reference_audio)을 업로드하면 그 목소리로 임의 텍스트를 합성합니다(제로샷). multipart/form-data 요청, response_format(wav/mp3/opus) 지원, 한국어 자동 전처리 적용.

복사# 제로샷 클론 → mp3
curl https://ai3.aiinplanet.com/v1/audio/clone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "input=복제할 목소리로 이 문장을 읽습니다." \
  -F "reference_audio=@myvoice.wav" \
  -F "model=vocos-lowadv" \
  -F "response_format=mp3" --output cloned.mp3

참고 사항

• model 값에 따라 백엔드가 자동 분기됩니다 — kokoro/tts-1/tts-1-hd → Kokoro(영어), styletts2/vocos-lowadv → StyleTTS2(한국어).
• 한국어 엔진 입력은 자동으로 발음 정규화(영문 낱자화·숫자·퍼센트·한자·괄호)됩니다 — 위 자동 한국어 전처리 참조.
• 파일이 필요하면 기본 모드, 즉시 재생이 필요하면 stream:true — 위 스트리밍 재생 참조.
• 응답은 JSON 이 아니라 오디오 바이너리입니다(timestamps:true 제외). --output 또는 SDK 의 stream_to_file 로 저장하세요.
• 보이스는 엔진별로 다릅니다. 영어 보이스는 Kokoro, 한국어 aiin_* 보이스는 StyleTTS2/vocos 에서만 동작합니다.
• 키가 없으면 401 Unauthorized 가 반환됩니다 (/v1/models 제외).