Tutorial de API de texto a voz con Python (2026): guía rápida de Audexum
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.
pip install requestsConsigue 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.
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:
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:
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 femalePasa 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:
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:
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 NoneReferencia de códigos de estado
Procesamiento por lotes
Para lotes de cadenas, respeta el límite de solicitudes con una breve pausa entre cada una:
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 resultsComparativa de precios
Antes de elegir un plan, aquí tienes una comparación del precio por carácter de las principales API de TTS:
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
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.
- Relacionado: API de síntesis de voz más barata en 2026
- Relacionado: Alternativa a ElevenLabs con nivel gratuito
- Relacionado: API de TTS para bots de Discord
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?