Preciso reescrever meu código?

Não. A API compatível com OpenAI do Fish Audio aceita a mesma requisição /v1/audio/speech dos SDKs oficiais de Python e Node. Troque base_url e api_key, defina um modelo do Fish e passe um ID de voz do Fish.

O fish-audio/s2.1-pro-free é gratuito mesmo?

Sim, até 30 de novembro de 2026, dentro dos limites de utilização justa. É o mesmo modelo do S2.1-Pro, sem garantias de tempo até o primeiro áudio (TTFA) nem DPA, e as requisições podem ser usadas para melhorar a qualidade do modelo. Use para testes e protótipos e depois mude para fish-audio/s2.1-pro em produção.

A transcrição de fala para texto migra do mesmo jeito?

Sim. /v1/audio/transcriptions aceita whisper-1, gpt-4o-transcribe e gpt-4o-mini-transcribe como aliases de fish-audio/transcribe-1. Áudio em chat completions e um WebSocket Realtime também são suportados; /v1/audio/translations não é.

O parâmetro instructions, o formato de stream sse e os formatos de saída aac e flac retornam 400. Os nomes de vozes predefinidas da OpenAI não estão disponíveis, e a API compatível não lista as vozes do Fish; explore-as na Biblioteca de vozes.

A OpenAI remove tts-1, tts-1-hd e gpt-4o-mini-tts da sua API em 6 de janeiro de 2027.Fonte

Alternativa ao OpenAI TTS: mantenha o SDK, troque a URL base

O Fish Audio atende a mesma chamada /v1/audio/speech. Aponte seu cliente OpenAI para o Fish, escolha o modelo gratuito e seu código de síntese de voz continua funcionando depois que os modelos TTS da OpenAI saírem do ar.

Obter chave de API grátis Obter chave de API grátis Ler o guia de migração Ler o guia de migração

Não é necessário cartão de crédito: fish-audio/s2.1-pro-free custa $0 até 30 de novembro de 2026.

Duas linhas redirecionam o cliente

base_url e api_key apontam o SDK oficial da OpenAI para o Fish. Na chamada, defina um modelo e uma voz do Fish. O novo código roda como está em uma conta nova com saldo de $0.

speech.py

import os from openai import OpenAI client = OpenAI(+Linha adicionada:     base_url="https://api.fish.audio/compat/v1",-Linha removida:     api_key=os.environ["OPENAI_API_KEY"],+Linha adicionada:     api_key=os.environ["FISH_API_KEY"],) with client.audio.speech.with_streaming_response.create(-Linha removida:     model="tts-1",-Linha removida:     voice="alloy",+Linha adicionada:     model="fish-audio/s2.1-pro-free",+Linha adicionada:     voice="",    input="Hello, world!",    response_format="mp3",) as response:    response.stream_to_file("speech.mp3")

import fs from "node:fs";import OpenAI from "openai"; const client = new OpenAI({+Linha adicionada:   baseURL: "https://api.fish.audio/compat/v1",-Linha removida:   apiKey: process.env.OPENAI_API_KEY,+Linha adicionada:   apiKey: process.env.FISH_API_KEY,}); const response = await client.audio.speech.create({-Linha removida:   model: "tts-1",-Linha removida:   voice: "alloy",+Linha adicionada:   model: "fish-audio/s2.1-pro-free",+Linha adicionada:   voice: "",  input: "Hello, world!",  response_format: "mp3",});fs.writeFileSync("speech.mp3", Buffer.from(await response.arrayBuffer()));

-Linha removida: curl https://api.openai.com/v1/audio/speech \-Linha removida:   -H "Authorization: Bearer $OPENAI_API_KEY" \+Linha adicionada: curl https://api.fish.audio/compat/v1/audio/speech \+Linha adicionada:   -H "Authorization: Bearer $FISH_API_KEY" \  -H "Content-Type: application/json" \  -d '{-Linha removida:     "model": "tts-1",-Linha removida:     "voice": "alloy",+Linha adicionada:     "model": "fish-audio/s2.1-pro-free",+Linha adicionada:     "voice": "",    "input": "Hello, world!",    "response_format": "mp3"  }' \  --output speech.mp3

Requer o SDK oficial da OpenAI (pip install openai ou npm install openai) e sua chave de API do Fish em FISH_API_KEY.

O que mais muda

voice recebe um ID de voz do Fish. Nomes predefinidos da OpenAI, como nova, retornam 400; uma string vazia usa a voz padrão do modelo.
No Fish, o padrão de response_format é pcm, não mp3. Defina o formato explicitamente.
instructions não é suportado e retorna 400. Em vez disso, escreva as indicações de interpretação no texto, como [whispering].
tts-1, tts-1-hd e gpt-4o-mini-tts continuam funcionando como nomes de modelo. Eles são mapeados para o modelo pago fish-audio/s2.1-pro.

Escolha uma voz

As vozes predefinidas da OpenAI não existem no Fish. Passe o ID de qualquer voz da Biblioteca de vozes do Fish ou de uma voz que você clonar. Uma string vazia usa a voz padrão do modelo.

Hannah · Biblioteca de vozes

voice="9a9cf47702da476aa4629e2506d4a857"

Explorar a Biblioteca de vozes

Preços

O S2.1-Pro cobra por bytes UTF-8 do texto de entrada. Em inglês, um caractere equivale a um byte, então o custo é o mesmo do tts-1 e metade do tts-1-hd. A maioria dos caracteres chineses, japoneses e coreanos ocupa 3 bytes.

Modelo	Preço	Observações
Fish Audiofish-audio/s2.1-pro-freeGrátis até 30 de novembro de 2026, dentro dos limites de utilização justa. Mesmo modelo do S2.1-Pro, sem garantias de latência (TTFA) nem DPA; as requisições podem ser usadas para melhorar o modelo.	$0.00 / 1M bytes UTF-8	Grátis até 30 de novembro de 2026, dentro dos limites de utilização justa. Mesmo modelo do S2.1-Pro, sem garantias de latência (TTFA) nem DPA; as requisições podem ser usadas para melhorar o modelo.
Fish Audiofish-audio/s2.1-proPara produção. Pague conforme o uso, sem assinatura.	$15.00 / 1M bytes UTF-8	Para produção. Pague conforme o uso, sem assinatura.
OpenAItts-1Removido da API da OpenAI em 6 de janeiro de 2027.	$15.00 / 1M caracteres	Removido da API da OpenAI em 6 de janeiro de 2027.
OpenAItts-1-hdRemovido da API da OpenAI em 6 de janeiro de 2027.	$30.00 / 1M caracteres	Removido da API da OpenAI em 6 de janeiro de 2027.

Preços das páginas oficiais de preços, verificados em 29 de outubro de 2026:Fish Audio OpenAI

Perguntas frequentes

A página de descontinuações da OpenAI lista tts-1, tts-1-hd e gpt-4o-mini-tts para remoção da API em 6 de janeiro de 2027. O substituto recomendado, gpt-realtime-2.1-mini, roda na Realtime API, e não em /v1/audio/speech.

Mude antes de 6 de janeiro de 2027

Crie uma chave grátis, troque duas linhas e continue entregando voz.