API 레퍼런스

VoiceGen AI REST API로 텍스트를 음성 WAV 파일로 변환할 수 있습니다.

기본 정보

Base URL	`https://vg.kiam.kr`
인증 방식	Bearer Token (API 키)
요청 형식	`application/json`
응답 형식	`audio/wav` (성공) / `application/json` (에러)

인증 헤더

Authorization: Bearer YOUR_API_KEY

POST /api/v1/generate

텍스트를 입력받아 음성 WAV 파일(바이너리)을 반환합니다.

요청 파라미터

파라미터	타입	필수	설명
`text`	string	✓	음성으로 변환할 텍스트
`voice_id`	string		음성 프리셋 ID (기본값: `ko_female_1`)
`speed`	float		재생 속도 0.5~2.0 (기본값: `1.0`)
`language`	string		언어 코드 `ko` / `en` (기본값: `ko`)

HTTP 상태 코드

코드	의미
`200`	성공 — WAV 바이너리 반환
`400`	잘못된 요청 (파라미터 누락·형식 오류)
`401`	인증 실패 (API 키 없음·만료)
`429`	사용량 한도 초과
`500`	서버 오류

코드 예제

curl

curl -X POST https://vg.kiam.kr/api/v1/generate   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"text":"안녕하세요. VoiceGen AI입니다.","voice_id":"ko_female_1","speed":1.0}'   --output output.wav

JavaScript (fetch)

const response = await fetch('https://vg.kiam.kr/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: '안녕하세요. VoiceGen AI입니다.',
    voice_id: 'ko_female_1',
    speed: 1.0
  })
});
const blob = await response.blob();
const audio = new Audio(URL.createObjectURL(blob));
audio.play();

PHP

$ch = curl_init('https://vg.kiam.kr/api/v1/generate');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'text'     => '안녕하세요. VoiceGen AI입니다.',
        'voice_id' => 'ko_female_1',
        'speed'    => 1.0
    ])
]);
$wav = curl_exec($ch);
file_put_contents('output.wav', $wav);

💡 전체 API 문서
더 자세한 엔드포인트와 예제는 vg.kiam.kr/docs.html에서 확인하세요.

🔊 VoiceGen AI 바로가기 →