블로그 목록

가이드

AI 전화용 Typecast TTS를 Python·Node SDK에 추가했어요

한국AI통신 Python SDK 0.78.0과 Node SDK 0.63.0에 TypecastTTS를 추가했어요. PipelineSession에서 Typecast 모델과 목소리를 고르고 자체 호스팅하는 AI 전화에 연결하는 방법을 코드로 보여 드려요.

안녕하세요. 한국AI통신에서 AI 에이전트를 위한 통화 인프라를 만들고 있어요.

앞서 콘솔에서 Typecast 목소리를 골라 ARS 안내와 AI 에이전트의 답변에 적용하는 방법을 소개했어요. 이번에는 자체 서버에서 코드로 전화 에이전트를 실행하는 분들도 같은 목소리를 고를 수 있도록, Python과 Node SDK에 TypecastTTS를 추가했어요. 콘솔에서 Typecast 목소리 설정하기

예약 시스템과 연결한 전화 에이전트를 예로 들어 볼게요. 발신자가 예약 시간을 물으면 에이전트가 예약을 조회하고, 확인한 시간을 문장으로 만들어요. Typecast는 그 문장을 골라 둔 목소리로 읽어 줘요. SDK에서는 이 마지막 단계를 PipelineSession의 tts에 연결하면 돼요.

Python과 Node에서 TypecastTTS를 연결해요

11월 19일 공개한 Python SDK 0.78.0과 Node SDK 0.63.0부터 사용할 수 있어요. 예제는 Deepgram으로 말을 받아쓰고 OpenAI 텍스트 모델로 답변을 만든 뒤 Typecast로 읽어요. Python 릴리스 · Node 릴리스

예제를 실행하는 서버에 한국AI통신의 CLAWOPS_API_KEY와 CLAWOPS_ACCOUNT_ID, 각 제공자의 DEEPGRAM_API_KEY, OPENAI_API_KEY, TYPECAST_API_KEY를 설정해요. 예제의 CLAWOPS_FROM_NUMBER에는 전화 에이전트에 연결할 한국AI통신 번호를 넣어요.

Python

pip install "koreaaitel[openai]==0.78.0"

koreaaitel을 설치하면 Python에서는 clawops로 가져와요. 아래처럼 TypecastTTS를 파이프라인에 넘기면 돼요. Python 패키지

import asyncio
import os

from clawops.agent import ClawOpsAgent
from clawops.agent.pipeline import (
    DeepgramSTT,
    OpenAILLM,
    PipelineSession,
    TypecastTTS,
)

agent = ClawOpsAgent(
    from_=os.environ["CLAWOPS_FROM_NUMBER"],
    session=PipelineSession(
        stt=DeepgramSTT(),
        llm=OpenAILLM(model="gpt-4o-mini"),
        tts=TypecastTTS(
            voice="tc_6af54d77f4d336c400d1370d",
            model="ssfm-v31",
        ),
    ),
)

asyncio.run(agent.serve())

파일을 agent.py로 저장하고 python agent.py로 실행해요.

Node.js

npm install @koreaaitel/sdk@0.63.0 openai

Node에서는 @koreaaitel/sdk/agent에서 TypecastTTS를 가져와요. 아래 예제를 agent.mjs로 저장해요. Node 패키지

import {
  ClawOpsAgent,
  DeepgramSTT,
  OpenAILLM,
  PipelineSession,
  TypecastTTS,
} from "@koreaaitel/sdk/agent";

const agent = new ClawOpsAgent({
  from: process.env.CLAWOPS_FROM_NUMBER,
  session: new PipelineSession({
    stt: new DeepgramSTT(),
    llm: new OpenAILLM({ model: "gpt-4o-mini" }),
    sampleRate: 16000,
    tts: new TypecastTTS({
      voice: "tc_6af54d77f4d336c400d1370d",
      model: "ssfm-v31",
    }),
  }),
});

await agent.serve();

node agent.mjs로 실행해요. 에이전트가 연결된 뒤에는 지정한 한국AI통신 번호로 전화해 답변을 들어볼 수 있어요.

모델과 목소리를 코드에서 골라요

예제의 목소리는 진헌이에요. 다른 목소리를 쓰려면 Typecast 음성 목록에서 원하는 voice_id를 찾아 voice에 넣으면 돼요. Typecast 계정에 등록된 커스텀 보이스도 그 계정의 API 키로 지정할 수 있어요. 보이스마다 지원 모델이 다르니 모델을 바꿀 때는 목록의 models를 확인해요. Typecast 음성 목록 API

기본 모델은 SSFM 3.1, 기본 언어는 한국어예요. 말하기 속도는 speed로 조절할 수 있어요. 자체 호스팅 구성이므로 음성 합성 요청은 서버에 설정한 Typecast API 키로 보내요.

코드에서 만든 음성이 실제 전화까지 전달되는지 확인했어요

Typecast의 스트리밍 API는 합성이 전부 끝나기 전부터 오디오를 조각으로 보내줘요. SDK는 WAV 헤더가 여러 조각에 나뉘어 와도 오디오 데이터의 시작 위치를 찾고, 전화에서 재생할 수 있도록 샘플레이트를 맞춰요. Typecast 스트리밍 API

릴리스 전에 Python과 Node SDK로 각각 테스트 전화를 걸었어요. 고정된 한국어 문장을 Typecast로 합성하고, 수신 측 음성을 SDK가 받은 합성 원본과 대조했어요. 두 SDK 모두 Typecast 음성이 실제 통화로 전달되는 것을 확인했어요.

어떤 에이전트에서 쓸 수 있나요?

ClawOpsAgent를 직접 실행하면서 STT, 텍스트 LLM, TTS를 따로 고르는 PipelineSession에서 사용할 수 있어요. SDK의 OpenAIRealtime이나 GeminiRealtime처럼 모델이 음성을 직접 만드는 세션은 각 모델의 보이스 설정을 사용해요. 한국AI통신 Voice Agent 문서

콘솔에서 에이전트를 관리하고 있다면 모델 · 음성에서 Typecast 목소리를 고를 수 있어요. 자체 서버에서 에이전트를 실행한다면 Python이나 Node의 PipelineSession에 TypecastTTS를 연결해 보세요. Python 파이프라인 예제 · Node 파이프라인 예제

관련 글 더 보기

Typecast 목소리로 AI 전화와 ARS 안내를 설정해요

한국AI통신 콘솔에 타입캐스트(Typecast) 음성을 추가했어요. 실제 설정 화면에서 AI 에이전트와 콜 플로우에 목소리를 적용하는 방법을 확인하고, 콜 플로우 전화 테스트 녹음을 들어 보세요.

Mistral Voxtral 3 정리: 받아쓰기·음성 합성·음성 에이전트 SDK와 한국어, 요금

Mistral이 10월 20일 발표한 Voxtral 3를 정리했어요. 받아쓰기·실시간 받아쓰기·음성 합성 모델과 음성 에이전트 SDK가 무엇을 하는지, 공식 비교 음성을 직접 들어 본 결과, 한국어가 어디까지 확인되는지, 요금과 전화 연결 조건을 담았어요.

Grok Voice 3.0으로 070 전화 상담원 만들기: 한국어 26개 목소리 실측과 요금 구조

xAI Grok Voice 3.0을 070 AI 전화 상담원으로 써 봤어요. 공식 발표·문서로 확인한 한국어 지원과 연결 시간 기준 요금, GPT-Live와 다른 점, 26개 목소리 실측과 실제 통화 녹음을 정리했어요.

Gemini Live API 로 한국어 voice agent 5분 만들기 — 한국AI통신 070 직접 연결

Google Gemini Live API를 한국AI통신 070 번호에 연결해 한국어 음성 에이전트를 만드는 가이드입니다. Python으로 전화를 걸고 받는 예제와 통화용 시스템 프롬프트, 통화가 끝난 뒤 요약과 녹취록을 확인하는 방법을 다룹니다.

GPT-Live 1.1에 한국어 목소리가 생겼어요: API가 열리기 전에 전화 상담원 준비하기

OpenAI GPT-Live 1.1이 한국어를 공식 지원하며 한국어 목소리 '햇살'·'한울'을 공개했어요. 공식 영상과 문서로 확인한 변경점, 아직 열리지 않은 API, 그리고 지금 GPT-Live 1로 070 전화 상담원을 만들어 두면 1.1에서 모델만 바꾸면 되는 이유를 정리했어요.

한국AI통신 AI 전화 API로 시작하기

070 번호 발급부터 AI 음성 통화까지, REST API 몇 줄이면 됩니다.