ModuVoiceModuVoice

안내 문서

개발자 API와 비디오 에디터 사용법을 안내합니다.

DEVELOPER API

API 문서

텍스트를 자연스러운 음성으로. 표준어·경상도·전라도·평양까지 한국어 71종의 보이스를 REST API로 호출하세요.

API 키 발급하기 →바로 호출 예제 보기

소개

모두보이스 API는 OpenAI 호환 스타일의 간단한 REST 엔드포인트로 음성 합성을 제공합니다. API 키만 있으면 어떤 언어/환경에서도 바로 호출할 수 있어요.

Base URL: https://api.moduvoice.com/api/v1

시작하기

  1. API 페이지에서 키를 발급합니다 (키는 발급 시 한 번만 표시).
  2. 키를 Authorization 헤더에 넣어 호출합니다.
  3. 응답으로 오디오 파일(mp3/wav)을 받습니다.

인증

모든 요청 헤더에 발급받은 API 키를 Bearer 토큰으로 전달합니다.

Authorization: Bearer mv_live_xxxxxxxxxxxxxxxxxxxx

대안: X-API-Key: mv_live_... 헤더도 지원합니다.

음성 합성 — POST /audio/speech

텍스트를 음성으로 합성합니다. 응답은 오디오 바이너리이며, 생성된 길이는 응답 헤더에 담깁니다.

voicestring · 필수
voice id (예: sera, byungho, jungwoong). 목록은 GET /voices 또는 캐릭터 캐스팅 참고
inputstring · 필수
읽을 텍스트(한국어)
response_formatstring · 선택
mp3(기본) 또는 wav
languagestring · 선택
언어 힌트(보통 생략 가능)
요청 예제
curl -X POST https://api.moduvoice.com/api/v1/audio/speech \
  -H "Authorization: Bearer $MODUVOICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"voice":"sera","input":"안녕하세요, 모두보이스입니다.","response_format":"mp3"}' \
  --output speech.mp3
응답

성공 시 200 과 오디오 바이너리(mp3=audio/mpeg, wav=audio/wav). 헤더 X-Audio-Duration-Seconds 에 차감된 길이(초)가 담깁니다.

voice 목록

아래 id 를 voice 파라미터에 그대로 넣어 사용하세요. 샘플은 캐릭터 캐스팅에서 들어볼 수 있어요.

🇰🇷 한국어 · 표준어 (49)
sera미스터리 세라byungho옛날앵커 병호kanghyun미스터리 강현chanho캐스터 찬호jungwoong내레이터 정웅gen_f5차분 예린hyunwoo다큐 현우seungjae해설가 승재taehun해설가 태훈sangchul승부사 상철sujin다큐 수진soeun동화이모 소은dajung동화 다정jinsu동네형님 진수gen_m1묵직 도현muyeol장군 무열gen_f2발랄 소율yanghwi책사 양휘gen_m2다정 준호dogyeong재상 도경gen_f3상큼 하린gen_m3신뢰 성재haneul동요이모 하늘eunyoung리포터 은영taesik입담꾼 태식jia내레이터 지아junghoon희극인 정훈manho능청남 만호dongsu상남자 동수woojin동화삼촌 우진kwangyul희극인 광열doyoon성우 도윤dusik막내 두식jaehoon사연꾼 재훈bora앵커 보라gen_f4포근 수아gen_m4당당 우진gen_f1또랑 지민gen_m5중후 태경gen_f6잔잔 윤서gen_m6또렷 민석misuk왕언니 미숙jeongyeon까칠사모 정연mansik까칠남 만식hyeonseok반듯한 현석jieun주부 지은byeongtae호탕아재 병태junghu진중 정후huibin희빈 정씨
🇰🇷 경상도 (10)
junghwan연설가 정환jongseok수다쟁이 종석dosik괴담꾼 도식minjae경상총각 민재woohyuk경상청년 우혁jongbum썰쟁이 종범sanggu경상형님 상구junjae허세남 준재jonggeun해결사 종근kangbok충성남 강복
🇰🇷 전라도 (3)
kwangbae전라형님 광배kwangsu전라총각 광수youngbae전라청년 영배
🇰🇷 평양 (9)
youngae평양앵커 영애youngsil평양앵커 영실okbyul평양앵커 옥별sunhee평양기자 순희jungok평양기자 정옥kwangchul평양앵커 광철myungsu평양앵커 명수sungkuk평양기자 성국jungnam평양기자 정남
프로그램으로 받기 — GET /voices
curl https://api.moduvoice.com/api/v1/voices -H "Authorization: Bearer $MODUVOICE_API_KEY"
{
  "voices": [
    { "id": "sera", "name": "미스터리 세라", "languages": ["ko"], "dialect": "표준어" },
    { "id": "junghwan", "name": "연설가 정환", "languages": ["ko"], "dialect": "경상도" }
  ]
}

사용량 · 요금

API 호출도 웹과 동일하게 플랜의 생성 시간에서 차감됩니다. 합성된 오디오 길이(초)만큼 차감되며, 남은 시간을 모두 사용하면 403 이 반환됩니다.

남은 시간은 사이드바 또는 플랜 관리에서 확인할 수 있습니다.

에러 코드

400잘못된 요청
알 수 없는 voice 등
401인증 실패
API 키 누락/무효
403한도 초과
이번 달 생성 시간 소진
422검증 실패
input(텍스트)이 비어 있음
502서버 오류
음성 서버 연결/합성 실패