Telnyx
Telnyx
Telnyx는 Vercel AI SDK용 AI SDK provider를 제공해서, 개발자가 단일 패키지로 채팅 모델, 임베딩, 음성-대-텍스트, 텍스트-대-음성을 이용할 수 있게 해 줘요.
다음을 원한다면 Telnyx provider가 잘 맞아요:
- 하나의 패키지로 여러 AI 기능: 채팅, 임베딩, 전사, 음성 생성
- OpenAI 호환 모델 접근: 익숙한 API 패턴으로 Telnyx 호스팅 모델 사용
- 같은 provider에서 음성 지원: 하나의 통합으로 텍스트와 음성 워크플로 결합
- 간단한 설정: AI SDK와 함께하는 표준 API 키 구성
더 자세한 내용은 Telnyx documentation을 참고하세요.
출처: 문서
본문
셋업 (Setup)
@telnyx/ai-sdk-provider 패키지(v2.0.0+)는 AI SDK 7과 Provider V4 명세를 지원해요.
AI SDK 7과 함께 설치하세요:
pnpm add @telnyx/ai-sdk-provider ai@^7 zod
npm install @telnyx/ai-sdk-provider ai@^7 zod
yarn add @telnyx/ai-sdk-provider ai@^7 zod
bun add @telnyx/ai-sdk-provider ai@^7 zod
Telnyx API 키를 환경 변수로 설정하세요:
export TELNYX_API_KEY="your_api_key_here"
Provider 인스턴스 (Provider Instance)
Telnyx provider 인스턴스를 만들려면 createTelnyx 함수를 사용하세요:
import { createTelnyx } from '@telnyx/ai-sdk-provider';
const telnyx = createTelnyx({
apiKey: proces...KEY,
});
환경에 TELNYX_API_KEY가 설정되어 있으면 기본 telnyx export를 사용할 수도 있어요.
예시 (Examples)
generateText
import { telnyx } from '@telnyx/ai-sdk-provider';
import { generateText } from 'ai';
const { text } = await generateText({
model: telnyx('Qwen/Qwen3-235B-A22B'),
prompt: 'Explain WebRTC in simple terms.',
});
console.log(text);
embed
import { telnyx } from '@telnyx/ai-sdk-provider';
import { embed } from 'ai';
const { embedding } = await embed({
model: telnyx.embeddingModel('thenlper/gte-large'),
value: 'What is WebRTC?',
});
console.log(embedding);
experimental_transcribe
import { telnyx } from '@telnyx/ai-sdk-provider';
import { experimental_transcribe as transcribe } from 'ai';
import { readFile } from 'node:fs/promises';
const result = await transcribe({
model: telnyx.transcriptionModel('distil-whisper/distil-large-v2'),
audio: await readFile('./audio.wav'),
});
console.log(result.text);
experimental_generateSpeech
import { telnyx } from '@telnyx/ai-sdk-provider';
import { experimental_generateSpeech as generateSpeech } from 'ai';
const { audio } = await generateSpeech({
model: telnyx.speech('Telnyx.NaturalHD.astra'),
text: 'Hello from Telnyx!',
voice: 'Telnyx.NaturalHD.astra',
});
await audio.writeToFile('./speech.mp3');