🎤 Channel TTS API — Quick Start

0. 토큰 준비

모든 TTS 호출은 /v1/external/text-to-speech/... 경로에 Authorization: Bearer <token> 헤더를 붙여서 수행합니다.

export CHTTS_API_KEY="<발급받은 토큰>"

1. Batch 호출

전체 오디오를 한 번에 생성해 WAV 파일로 저장합니다.

curl -sS -X POST 'https://ch-tts-streaming-demo.channel.io/v1/external/text-to-speech/test-voice' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $CHTTS_API_KEY" \
  -d '{"text":"안녕하세요, 채널톡입니다.","output_format":"wav_24000"}' \
  --output out.wav \
  -w '\nHTTP_STATUS:%{http_code}\n'

정상 응답: 200 + out.wav (RIFF/WAVE, 24kHz mono)

로컬 재생 (macOS)

afplay out.wav

2. Stream 호출

오디오 청크를 실시간으로 스트리밍합니다. output_format은 pcm_*만 지원합니다 (스트림 응답은 wav_*를 지원하지 않습니다).

curl -sS -N -X POST 'https://ch-tts-streaming-demo.channel.io/v1/external/text-to-speech/test-voice/stream?optimize_streaming_latency=0' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $CHTTS_API_KEY" \
  -d '{"text":"안녕하세요, 채널톡입니다.","output_format":"pcm_24000"}' \
  --output out.pcm \
  -w '\nHTTP_STATUS:%{http_code}\n'

정상 응답: 200 + out.pcm (raw PCM16LE, mono, 24000Hz)

로컬 재생 (macOS) — PCM을 WAV로 감싸서 재생

python3 - <<'PY'
import wave
with open("out.pcm", "rb") as f:
    data = f.read()
with wave.open("out_from_stream.wav", "wb") as w:
    w.setnchannels(1)
    w.setsampwidth(2)
    w.setframerate(24000)
    w.writeframes(data)
PY
afplay out_from_stream.wav

ffplay로 파일 저장 없이 바로 재생

curl -sS -N -X POST 'https://ch-tts-streaming-demo.channel.io/v1/external/text-to-speech/test-voice/stream?optimize_streaming_latency=0' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $CHTTS_API_KEY" \
  -d '{"text":"안녕하세요, 채널톡입니다.","output_format":"pcm_24000"}' \
| ffplay -nodisp -autoexit -f s16le -ar 24000 -ch_layout mono -i -

3. 인증 동작 확인 (선택)

토큰 게이팅이 의도대로 동작하는지 빠르게 검증하고 싶을 때:

케이스	기대 결과
external 엔드포인트, 토큰 없음	401
external 엔드포인트, 올바른 토큰 (batch)	200
external 엔드포인트, 올바른 토큰 (stream)	200

# external 엔드포인트, 토큰 없이 -> 401
curl -sS -o /dev/null -X POST 'https://ch-tts-streaming-demo.channel.io/v1/external/text-to-speech/test-voice' \
  -H 'Content-Type: application/json' \
  -d '{"text":"test","output_format":"wav_24000"}' \
  -w 'HTTP_STATUS:%{http_code}\n'

# external 엔드포인트, 올바른 토큰 -> 200
curl -sS -o /dev/null -X POST 'https://ch-tts-streaming-demo.channel.io/v1/external/text-to-speech/test-voice' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $CHTTS_API_KEY" \
  -d '{"text":"test","output_format":"wav_24000"}' \
  -w 'HTTP_STATUS:%{http_code}\n'

참고

· voice_id는 현재 무시되며 값은 무관합니다 (예시에서는 test-voice 사용).

· /health, /ping은 인증 없이 항상 호출 가능합니다.

· 인터랙티브 API 문서(파라미터/스키마/Try it out)는 Swagger UI 또는 ReDoc에서 확인하세요.