Saltar al contenido

Tutorial de API de texto a voz con Python (2026): guía rápida de Audexum

Audexum8 minBy Petar

Aprende a llamar a una API de texto a voz en Python con la biblioteca requests. Ejemplos de código completos para elegir voces, generar archivos WAV, gestionar errores y comparar precios.

Integrar la síntesis de voz en un proyecto de Python requiere menos de 20 líneas de código. Esta guía explica todo: autenticación, elección de voz, guardado de la salida WAV, gestión de errores y selección del plan adecuado para tu uso.

Todos los ejemplos usan API TTS de Audexum, que admite 43 voces en 32 idiomas y ofrece un nivel gratuito sin necesidad de tarjeta de crédito.

Requisitos previos

Solo necesitas la biblioteca requests . Sin SDK ni framework.

bash
pip install requests

Consigue una clave de API gratuita en audexum.com/signup. Las claves siguen el formato sk_live_abc123xyz. El plan gratuito te ofrece 2.000 créditos gratuitos + 250 al día sin necesidad de tarjeta.

Primera llamada a la API

El endpoint acepta un cuerpo JSON con text, voice_id, y opcionalmente de idioma. Devuelve audio WAV en 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}")

Ejecútalo y obtendrás output.wav en el directorio actual. Esta es la implementación completa y funcional.

Selección de voz

Audexum tiene 43 voces en inglés estadounidense, inglés británico, español, francés, alemán, japonés, coreano, árabe, hindi, búlgaro, italiano, portugués y más. Consulta las voces disponibles con una solicitud 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']}")

Ejemplo de salida:

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

Pasa la cadena voice_id directamente en tu solicitud de síntesis.

Guardado del archivo WAV

El cuerpo de la respuesta es PCM WAV sin procesar: no necesitas decodificar base64. Escríbelo en disco con las operaciones de archivo estándar:

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)")

Si necesitas MP3 en lugar de WAV, pasa "format": "mp3" en el cuerpo JSON.

Gestión de errores

Gestiona explícitamente los límites de solicitudes, las voces no válidas y los errores de autenticación:

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

Referencia de códigos de estado

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

Procesamiento por lotes

Para lotes de cadenas, respeta el límite de solicitudes con una breve pausa entre cada una:

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

Comparativa de precios

Antes de elegir un plan, aquí tienes una comparación del precio por carácter de las principales API de TTS:

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

Los suscriptores de planes de Audexum obtienen tarifas efectivas de entre 9,93 €/1 M (Business) y 24,17 €/1 M (Pro). La opción PAYG a 28 €/1 M de créditos resulta útil para proyectos con un volumen impredecible, y los paquetes de créditos de pago único nunca caducan.

Resumen de planes

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 pasos

La implementación completa en Python cabe en menos de 30 líneas. El nivel gratuito es suficiente para crear y probar una integración completa antes de gastar nada.

Consigue tu clave de API en audexum.com/signup y consulta la Referencia de la API para ver la lista completa de parámetros, incluidos los controles de velocidad, tono y formato de salida.


Por Petar, fundador de Audexum. Dirigir un SaaS de TTS financiado con los ingresos propios te da opiniones muy fundamentadas sobre el diseño de API.

Got any questions left?

Compartir opinión

¿Te ha sido útil este artículo?

Siguiente artículoAPI de texto a voz multilingüe: 33 idiomas con un único endpoint REST (2026)

Empieza gratis. Sin tarjeta.

2,000 créditos para empezar, 250 más cada día.