하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
curl -X POST https://runapi.ai/api/v1/openai_tts/text_to_speech \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"text": "이 제품 온보딩 대본을 앱 내 안내에 어울리는 또렷하고 자연스러운 음성으로 변환하세요."
}'import { OpenaiTtsClient } from "@runapi.ai/openai-tts";
const client = new OpenaiTtsClient();
const result = await client.textToSpeech.run({
model: "tts-1-hd",
text: "이 제품 온보딩 대본을 앱 내 안내에 어울리는 또렷하고 자연스러운 음성으로 변환하세요.",
});require "runapi/openai_tts"
client = RunApi::OpenaiTts::Client.new
result = client.text_to_speech.run(
model: "tts-1-hd",
text: "이 제품 온보딩 대본을 앱 내 안내에 어울리는 또렷하고 자연스러운 음성으로 변환하세요."
)npx skills add runapi-ai/openai-tts -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor개요
OpenAI TTS 소개
OpenAI TTS는 RunAPI의 동기식 엔드포인트에서 텍스트를 음성으로 변환합니다. 빠른 응답이 중요한 애플리케이션에는 tts-1을, 더 높은 음질의 내레이션에는 tts-1-hd를 선택하세요. 두 모델 모두 RunAPI가 관리하는 MP3 URL을 반환합니다.
제공사
OpenAI
모달리티
Audio & Music
변형
요금
OpenAI TTS 요금
| endpoint | 해상도 | 길이 | 가격 | |
|---|---|---|---|---|
| text_to_speech | — | — | $0.03 / 1K UTF-8 bytes |
tts-1 기준 요금입니다. 다른 변형은 각자의 endpoint 요금이 적용됩니다.
에이전트 통합
에이전트에서 OpenAI TTS 실행
작동 방식
OpenAI TTS 시작하기
-
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
-
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
-
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
-
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
RunAPI로 OpenAI TTS을 쓰는 이유
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
OpenAI TTS FAQ
tts-1과 tts-1-hd의 차이점은 무엇인가요?
tts-1은 실시간 상호작용에 필요한 짧은 지연 시간을 우선하고, tts-1-hd는 내레이션과 최종 제작물에 필요한 더 높은 음질을 우선합니다.
OpenAI TTS는 어떤 오디오 형식을 반환하나요?
두 모델 모두 RunAPI 응답에 형식, MIME 유형, 바이트 크기 메타데이터와 함께 MP3 오디오를 반환합니다.
생성된 오디오는 RunAPI에서 호스팅하나요?
네. RunAPI는 오디오를 검증한 뒤 임시 원본 URL 대신 RunAPI가 관리하는 URL을 반환합니다.
사용자 지정 음성이나 속도를 선택할 수 있나요?
현재 엔드포인트는 공개된 기본 음성과 속도만 사용합니다. 사용자 지정 음성과 속도 제어는 이 엔드포인트의 API 규격에 포함되지 않습니다.
텍스트 음성 변환 요청은 동기식인가요?
네. 요청이 성공하면 별도의 상태 조회 엔드포인트 없이 완성된 오디오를 바로 반환합니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
유사 모델