Tutorial de API de texto para fala em Python (2026): guia rápido do Audexum
Saiba como chamar uma API de texto para voz em Python usando a biblioteca requests. Exemplos completos de código para seleção de voz, saída WAV, tratamento de erros e comparação de preços.
Integrar texto para fala a um projeto Python leva menos de 20 linhas de código. Este guia explica tudo: autenticação, escolha de voz, salvamento da saída WAV, tratamento de erros e escolha do plano ideal para seu uso.
Todos os exemplos usam a API de TTS do Audexum, que oferece 43 vozes em 32 idiomas e um plano gratuito sem necessidade de cartão de crédito.
Pré-requisitos
Você só precisa da biblioteca requests . Sem SDK, sem framework.
pip install requestsObtenha uma chave de API gratuita em audexum.com/signup. As chaves seguem o formato sk_live_abc123xyz. O plano gratuito oferece 2,000 créditos gratuitos + 250 por dia, sem necessidade de cartão.
Primeira chamada à API
O endpoint aceita um corpo JSON com text, voice_id, e opcionalmente idioma. Ele retorna áudio WAV bruto.
import requests
API_KEY = "sk_live_abc123xyz"
API_URL = "https://audexum.com/api/v1/tts"
response = requests.post(
API_URL,
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"text": "Hello, this is a test of the Audexum text-to-speech API.",
"voice_id": "en_us_female_01",
},
)
if response.status_code == 200:
with open("output.wav", "wb") as f:
f.write(response.content)
print("Saved output.wav")
else:
print(f"Error {response.status_code}: {response.text}")Execute o código e você receberá o arquivo output.wav no diretório atual. Essa é a implementação completa e funcional.
Como escolher uma voz
O Audexum tem 43 vozes em inglês americano, inglês britânico, espanhol, francês, alemão, japonês, coreano, árabe, hindi, búlgaro, italiano, português e outros idiomas. Liste as vozes disponíveis com uma requisição GET:
import requests
API_KEY = "sk_live_abc123xyz"
voices = requests.get(
"https://audexum.com/api/v1/voices",
headers={"Authorization": f"Bearer {API_KEY}"},
).json()
for voice in voices:
print(f"{voice['voice_id']:30s} {voice['language']:10s} {voice['gender']}")Exemplo de saída:
en_us_female_01 en-US female
en_us_male_01 en-US male
en_gb_female_01 en-GB female
de_female_01 de female
ja_female_01 ja femalePasse a string voice_id diretamente na sua requisição de síntese.
Salvando o arquivo WAV
O corpo da resposta é um WAV PCM bruto: não é necessário decodificar base64. Grave-o em disco com as operações de arquivo padrão:
import requests
from pathlib import Path
def synthesize(text: str, voice_id: str, output_path: str, api_key: str) -> Path:
response = requests.post(
"https://audexum.com/api/v1/tts",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
json={"text": text, "voice_id": voice_id},
)
response.raise_for_status()
path = Path(output_path)
path.write_bytes(response.content)
return path
# Usage
output = synthesize(
text="Welcome to our application.",
voice_id="en_us_female_01",
output_path="welcome.wav",
api_key="sk_live_abc123xyz",
)
print(f"Audio saved to {output} ({output.stat().st_size} bytes)")Se você precisar de MP3 em vez de WAV, passe "format": "mp3" no corpo JSON.
Tratamento de erros
Trate explicitamente limites de requisições, vozes inválidas e erros de autenticação:
import requests
from requests.exceptions import RequestException
def safe_synthesize(text: str, voice_id: str, api_key: str) -> bytes | None:
try:
response = requests.post(
"https://audexum.com/api/v1/tts",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
json={"text": text, "voice_id": voice_id},
timeout=30,
)
if response.status_code == 401:
raise ValueError("Invalid API key. Check your sk_live_ token.")
if response.status_code == 402:
raise RuntimeError("Character quota exceeded. Upgrade your plan or wait for reset.")
if response.status_code == 422:
raise ValueError(f"Invalid request: {response.json().get('detail')}")
response.raise_for_status()
return response.content
except RequestException as e:
print(f"Network error: {e}")
return NoneReferência de códigos de status
Processamento em lote
Para lotes de strings, fique abaixo do limite de requisições com um pequeno atraso entre cada requisição:
import time
import requests
from pathlib import Path
def batch_synthesize(items: list[dict], api_key: str, delay: float = 0.2):
"""
items: [{"text": "...", "voice_id": "...", "output": "file.wav"}, ...]
"""
results = []
for item in items:
response = requests.post(
"https://audexum.com/api/v1/tts",
headers={"Authorization": f"Bearer {api_key}"},
json={"text": item["text"], "voice_id": item["voice_id"]},
)
if response.ok:
Path(item["output"]).write_bytes(response.content)
results.append({"file": item["output"], "status": "ok"})
else:
results.append({"file": item["output"], "status": response.status_code})
time.sleep(delay)
return resultsComparação de preços
Antes de escolher um plano, veja como as principais APIs de TTS se comparam em preço por caractere:
Os assinantes de planos do Audexum obtêm preços efetivos de €9.93/1M (Business) a €24.17/1M (Pro). A opção PAYG a €28/1M de créditos é útil para projetos com volume imprevisível, e os pacotes de créditos únicos nunca expiram.
Resumo dos planos
Próximos passos
A implementação completa em Python cabe em menos de 30 linhas. O plano gratuito é suficiente para criar e testar uma integração completa antes de gastar qualquer coisa.
Obtenha sua chave de API em audexum.com/signup e consulte a Referência da API para ver a lista completa de parâmetros, incluindo controles de velocidade, tom e formato de saída.
- Relacionado: API de texto para fala mais barata em 2026
- Relacionado: Alternativa ao ElevenLabs com plano gratuito
- Relacionado: API de TTS para bots do Discord
Por Petar, fundador do Audexum. Administrar um SaaS de TTS sem investidores me deu opiniões fortes sobre design de APIs.
Got any questions left?
Compartilhar feedback
Este artigo foi útil?