OpenAI TTS API
지연 시간이 짧은 고품질 텍스트 음성 변환(TTS)과 RunAPI가 관리하는 MP3 출력을 제공하는 OpenAI TTS API를 사용하세요.
curl -X POST https://runapi.ai/api/v1/openai_tts/text_to_speech \
-H "Authorization: Bearer $RUNAPI_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 cursorOpenAI TTS는 RunAPI의 동기식 엔드포인트에서 텍스트를 음성으로 변환합니다. 빠른 응답이 중요한 애플리케이션에는 tts-1을, 더 높은 음질의 내레이션에는 tts-1-hd를 선택하세요. 두 모델 모두 RunAPI가 관리하는 MP3 URL을 반환합니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
변형
앱 개발을 위해 OpenAI TTS skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/openai-tts -gInstall the OpenAI TTS skill for this app: 1. Add runapi-ai/openai-tts with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
이 model skill로 구현하는 방법
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
OpenAI TTS의 위치
OpenAI TTS는 실시간 상호작용과 완성도 높은 내레이션에 특화된 텍스트 음성 변환 모델을 제공합니다. RunAPI에서는 두 모델이 같은 요청 형식을 사용하며, RunAPI가 관리하는 오디오의 메타데이터를 반환합니다.
RunAPI로 OpenAI TTS을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
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와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.