OpenAI Audio → Brainiall TTS · guia de migração

Troque uma chamada de voz com o contrato à vista.

Migration request builder · processamento local

Gere a mudança explícita, sem fingir compatibilidade.

O texto abaixo permanece neste navegador. Nenhuma requisição é feita por esta ferramenta. O código gerado só envia o texto à Brainiall quando você o executar no seu próprio backend ou terminal.

Texto da requisição atual

Não cole segredo, dado pessoal ou texto sem direito de uso.66/5.000 caracteres

OpenAI input: Brainiall textPreservado como texto
OpenAI voice/model: voice: pf_doraSubstituição explícita
response_format: audio/wavVerificado na resposta

// Execute somente em um backend confiável (Node.js/TypeScript).
// Isto e um adaptador explicito, nao uma troca de base_url compativel.
// O texto sera processado por um servico Brainiall hospedado e medido.

type ExistingOpenAiSpeechRequest = {
  input: string;
  model?: string;
  voice?: string;
  response_format?: string;
  instructions?: string;
};

const currentRequest: ExistingOpenAiSpeechRequest = {
  input: "Olá. Este é um teste curto de migração para a voz brasileira Dora.",
  // Os demais campos OpenAI nao sao traduzidos automaticamente.
};

const apiKey = process.env.BRAINIALL_API_KEY;
if (!apiKey) throw new Error("BRAINIALL_API_KEY ausente no servidor");

const response = await fetch(
  "https://api.brainiall.com/v1/tts/synthesize",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      text: currentRequest.input,
      voice: "pf_dora",
    }),
  },
);

if (!response.ok) {
  throw new Error(`Brainiall TTS falhou: HTTP ${response.status}`);
}

const contentType = response.headers.get("content-type") ?? "";
if (!contentType.toLowerCase().includes("audio/wav")) {
  throw new Error(`Resposta inesperada: ${contentType || "sem content-type"}`);
}

const wavBytes = new Uint8Array(await response.arrayBuffer());
// Salve ou devolva wavBytes pelo seu backend. Nao envie a API key ao navegador.

A chave nunca é solicitada nem incluída no exemplo.

Contrato mínimo verificado

O endpoint Brainiall recebe JSON autenticado com text e um identificador de voz. O exemplo fixa a voz brasileira pf_dora. Uma síntese bem-sucedida retorna áudio WAV e o adaptador verifica audio/wav antes de tratar os bytes como som. O gerador não faz chamada de rede e não solicita credencial.

O que não é traduzido

Um nome de voz, modelo, instrução, semântica de streaming ou formato alternativo da requisição OpenAI não é reutilizado automaticamente. A voz pf_dora é uma nova escolha explícita, e a saída deste caminho é WAV. Se o seu fluxo depende de outro comportamento, trate a migração como bloqueada até validar um contrato específico.

Processamento hospedado e medido

Ao executar o código gerado, o texto é enviado ao serviço hospedado da Brainiall para síntese. O consumo é medido pela chave da conta e pode gerar cobrança depois dos créditos disponíveis. Não envie texto confidencial, dado pessoal ou conteúdo sem autorização. Faça primeiro uma frase curta e confira o WAV inteiro antes de automatizar volume.

Chave somente no servidor

Guarde BRAINIALL_API_KEY em variável de ambiente ou secret store do backend. Não coloque a chave em componente React, bundle do navegador, URL, repositório, log, issue ou captura de tela. O exemplo usa apenas um marcador de ambiente e falha se ele estiver ausente.

Valide antes de migrar tráfego

Compare a mesma frase nos dois caminhos, confirme pronúncia, duração, cabeçalho WAV, tratamento de erro e custo. Só depois substitua uma chamada real. Código gerado, clique ou teste do proprietário não comprova compatibilidade completa, comprador ou receita.

Conferir documentação Abrir app e criar chave