OpenAI TTS API
Acesso à API do OpenAI TTS para text-to-speech de baixa latência e alta qualidade, com saída MP3 gerenciada pelo RunAPI.
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": "Converta este roteiro de onboarding do produto em uma fala clara e natural para um passo a passo dentro do aplicativo."
}'
import { OpenaiTtsClient } from "@runapi.ai/openai-tts";
const client = new OpenaiTtsClient();
const result = await client.textToSpeech.run({
model: "tts-1-hd",
text: "Converta este roteiro de onboarding do produto em uma fala clara e natural para um passo a passo dentro do aplicativo.",
});
require "runapi/openai_tts"
client = RunApi::OpenaiTts::Client.new
result = client.text_to_speech.run(
model: "tts-1-hd",
text: "Converta este roteiro de onboarding do produto em uma fala clara e natural para um passo a passo dentro do aplicativo."
)
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 converte texto em fala por um endpoint síncrono do RunAPI. Escolha tts-1 para aplicações sensíveis à latência ou tts-1-hd para narrações de maior fidelidade. Ambos retornam uma URL de MP3 gerenciada.
- Variantes para diferentes metas de qualidade e latência
- API key unificada
- O model skill inclui documentação, schemas e notas de setup
- Gerações com falha não são cobradas
Variantes
Instale o skill OpenAI TTS para desenvolver apps
Carregue documentação do modelo, schemas, notas de preço e etapas de setup no seu workspace de código.
# Install the model skill for app development workflows
npx skills add runapi-ai/openai-tts -g
Install 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.
Como construir com este model skill
Escolha o modelo
Selecione o modelo e a variante que combinam com seu tipo de saída, meta de qualidade e latência.
Autentique uma vez
Use sua chave RunAPI para todos os modelos compatíveis.
Instale o skill
Adicione o model skill ao workspace de código antes de implementar a funcionalidade.
Receba a saída
Consulte por task ID ou trate o callback quando a geração terminar.
Onde OpenAI TTS se encaixa
OpenAI TTS oferece modelos específicos de text-to-speech para reprodução interativa e narrações com acabamento profissional. No RunAPI, as duas variantes usam o mesmo formato de requisição e retornam metadados de áudio gerenciados.
Por que usar OpenAI TTS pela RunAPI
Uma API key
Use as mesmas credenciais entre modelos e provedores.
Pronto para skills
O model skill inclui schemas, notas de setup, contexto de preços e IDs de modelo.
Cobrança previsível
O preço por uso fica visível antes da chamada.
Perguntas frequentes
Qual é a diferença entre tts-1 e tts-1-hd?
tts-1 prioriza baixa latência para reprodução interativa, enquanto tts-1-hd prioriza maior qualidade de áudio para narrações e conteúdo finalizado.
Qual formato de áudio o OpenAI TTS retorna?
As duas variantes retornam áudio MP3 com metadados de formato, tipo MIME e tamanho em bytes na resposta do RunAPI.
O áudio gerado fica hospedado no RunAPI?
Sim. O RunAPI valida o áudio e retorna uma URL gerenciada, sem expor uma URL temporária da origem.
Posso escolher uma voz ou velocidade personalizada?
O endpoint inicial usa a voz e a velocidade padrão publicadas. Controles personalizados de voz e velocidade não fazem parte do contrato deste endpoint.
O text-to-speech é síncrono?
Sim. Uma requisição bem-sucedida retorna diretamente o áudio concluído, sem exigir um endpoint separado de polling.
Como chamo este modelo?
Instale o model skill e siga as notas de setup com sua chave RunAPI.
Gerações com falha custam dinheiro?
Gerações com falha não são cobradas
Posso chamar a partir da minha aplicação?
Sim. Instale o model skill no workspace de código e use durante a implementação da funcionalidade.