OpenAI · 오디오 & 음악

OpenClaw x OpenAI TTS

OpenAI TTS는 실시간 상호작용과 완성도 높은 내레이션에 특화된 텍스트 음성 변환 모델을 제공합니다. RunAPI에서는 두 모델이 같은 요청 형식을 사용하며, RunAPI가 관리하는 오디오의 메타데이터를 반환합니다.

2 variants 최저 $0.02 / 1,000 UTF-8 바이트 상업적 사용 지원
API 키 받기 OpenClaw 문서 보기

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 tts-1를 사용하세요: 인터랙티브 애플리케이션을 위한 저지연 음성 합성.

You have access to RunAPI task tools for OpenAI TTS.

Available OpenAI TTS models:
- tts-1: 인터랙티브 애플리케이션을 위한 저지연 음성 합성
  endpoints: /api/v1/openai_tts/text_to_speech
  request fields: model, text
- tts-1-hd: 완성도 높은 내레이션을 위한 고품질 음성 합성
  endpoints: /api/v1/openai_tts/text_to_speech
  request fields: model, text

Use the model ID and endpoint that match the user's request.
Example prompt: 이 제품 온보딩 대본을 앱 내 안내에 어울리는 또렷하고 자연스러운 음성으로 변환하세요.
/api/v1/openai_tts/text_to_speech: Submit the request and verify the synchronous output. POST /api/v1/openai_tts/text_to_speech를 실행하고 동기 응답이 엔드포인트 API 레퍼런스와 일치하는지 확인합니다.

공개 버전 및 엔드포인트

모델 ID 엔드포인트 시작 가격 모델 카탈로그
tts-1
/api/v1/openai_tts/text_to_speech
$0.02 / 1,000 UTF-8 바이트 모델 상세
tts-1-hd
/api/v1/openai_tts/text_to_speech
$0.03 / 1,000 UTF-8 바이트 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

OpenClaw + OpenAI TTS로 만들 수 있는 것

  • 보이스오버와 내레이션

    음성을 생성하는 모델로 대본을 영상, 강의, 제품 데모용 음성으로 바꿉니다.

  • 음악과 사운드트랙

    음악을 생성하는 모델로 장르, 분위기, 템포 설명에서 배경 음악과 징글을 만듭니다.

  • 전사와 오디오 처리

    오디오 입력을 받는 모델로 녹음을 텍스트로 전사하거나 기존 오디오를 정리하고 변환합니다.

OpenAI TTS을(를) RunAPI + OpenClaw로 사용하는 이유

  • 2개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 즉시 응답

    동기 호출은 같은 응답 안에 결과를 반환하므로 에이전트가 작업 상태를 폴링하지 않고 바로 결과를 사용할 수 있습니다.

OpenClaw + OpenAI TTS 자주 묻는 질문

tts-1과 tts-1-hd의 차이점은 무엇인가요?

tts-1은 실시간 상호작용에 필요한 짧은 지연 시간을 우선하고, tts-1-hd는 내레이션과 최종 제작물에 필요한 더 높은 음질을 우선합니다.

OpenAI TTS는 어떤 오디오 형식을 반환하나요?

두 모델 모두 RunAPI 응답에 형식, MIME 유형, 바이트 크기 메타데이터와 함께 MP3 오디오를 반환합니다.

생성된 오디오는 RunAPI에서 호스팅하나요?

네. RunAPI는 오디오를 검증한 뒤 임시 원본 URL 대신 RunAPI가 관리하는 URL을 반환합니다.

사용자 지정 음성이나 속도를 선택할 수 있나요?

현재 엔드포인트는 공개된 기본 음성과 속도만 사용합니다. 사용자 지정 음성과 속도 제어는 이 엔드포인트의 API 규격에 포함되지 않습니다.

텍스트 음성 변환 요청은 동기식인가요?

네. 요청이 성공하면 별도의 상태 조회 엔드포인트 없이 완성된 오디오를 바로 반환합니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

OpenClaw에서 OpenAI TTS 사용 시작하기

API 키 받기 빠른 시작 읽기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기