Ir para o conteúdo

Tutorial de API de texto para fala em Python (2026): guia rápido do Audexum

Audexum8 minBy Petar

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.

bash
pip install requests

Obtenha 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.

python
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:

python
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:

text
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         female

Passe 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:

python
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:

python
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 None

Referência de códigos de status

CodeMeaningAction
200SuccessWrite response body to file
401Bad API keyCheck the Authorization header
402Quota exceededUpgrade plan or wait for monthly reset
422Bad request bodyCheck voice_id and text fields
429Rate limitedRetry with exponential backoff
500Server errorRetry once, then contact support

Processamento em lote

Para lotes de strings, fique abaixo do limite de requisições com um pequeno atraso entre cada requisição:

python
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 results

Comparação de preços

Antes de escolher um plano, veja como as principais APIs de TTS se comparam em preço por caractere:

ProviderFree TierPaid EntryCost per 1M charsCard Required for Free
Audexum2K to start€29 / 1.2M~€28.00 (PAYG)No
ElevenLabs10K credits/mo$6 / 30K~$165–$200Yes (some plans)
OpenAI TTSNonePay-as-you-go~$15Yes
Google Cloud TTS4M standard + 1M WaveNet/moPay-as-you-go$4 standard / $16 WaveNetYes

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

PlanCredits/moPriceBest For
Free2,000 + 250/day€0Prototypes, testing
Pro1,200,000€29Production apps
Scale4,000,000€49High-volume pipelines
Credit packs250,000 to 3,500,000, never expirefrom €7Bursty or unpredictable load

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.


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?

Próximo artigoAPI multilíngue de texto para fala: 33 idiomas com um único endpoint REST (2026)

Comece grátis. Sem cartão.

2,000 créditos para começar, 250 por dia.