API Documentation
SEO&OH VOICE API로 한국어, 일본어, 영어 음성을 생성하세요. Creator 플랜(79,000원/월)부터 사용 가능합니다.
ℹAPI 키는 로그인 후 대시보드 > Settings > API Keys에서 발급받을 수 있습니다.
Quick Start
5줄로 첫 음성을 생성하세요.
PythonJavaScriptcURL
import requests
response = requests.post(
"https://voice.seoandoh.kr/api/v1/tts",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"text": "안녕하세요. SEO&OH VOICE입니다.",
"voice": "minji",
"language": "ko"
}
)
with open("output.mp3", "wb") as f:
f.write(response.content)Authentication
모든 API 요청에 Bearer 토큰을 포함해야 합니다.
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx
⚠API 키를 절대 클라이언트 사이드(프론트엔드)에 노출하지 마세요.
Rate Limits
모든 응답 헤더에 남은 한도가 포함됩니다.
X-RateLimit-Limit: 1000000
X-RateLimit-Used: 152680
X-RateLimit-Remaining: 847320
X-RateLimit-Reset: 2026-05-01T00:00:00Z
X-RateLimit-Used: 152680
X-RateLimit-Remaining: 847320
X-RateLimit-Reset: 2026-05-01T00:00:00Z
Text to Speech
POST/api/v1/tts
| Parameter | Type | Description |
|---|---|---|
| text required | string | 변환할 텍스트 (최대 5,000자) |
| voice required | string | 음성 ID (예: "minji", "taeho") |
| language | string | "ko", "ja", "en" |
| speed | float | 0.5 ~ 2.0 (기본: 1.0) |
| emotion | string | "happy", "sad", "angry", "whisper" |
Streaming
WSwss://voice.seoandoh.kr/api/v1/tts/stream
WebSocket으로 실시간 스트리밍. 첫 바이트 지연 ~150ms.
Voices
GET/api/v1/voices
Clone Voice
POST/api/v1/voices/cloneCreator+
Design Voice
POST/api/v1/voices/designPro+
Error Handling
| Code | Status | Description |
|---|---|---|
| invalid_api_key | 401 | API 키가 유효하지 않음 |
| plan_required | 403 | 상위 플랜 필요 |
| rate_limit_exceeded | 429 | 월간 사용량 초과 |
| text_too_long | 400 | 텍스트 5,000자 초과 |
| server_error | 500 | 서버 오류 |
✓궁금한 점이 있으시면 support@seoandoh.kr로 문의해 주세요.