API de VozAlta — Documentación para Desarrolladores

¿Qué es VozAlta?

VozAlta es una API REST que convierte texto plano, PDFs o URLs de artículos en audio MP3 narrado con voces naturales en español. Ideal para apps de accesibilidad, podcasts automáticos, lectores de noticias y herramientas educativas.

Gratis: 5 generaciones/hora, 20/día por IP. Sin API key requerida.

Pro ($7/mes): Sin límites. Lifetime ($49): Acceso de por vida.

También ofrecemos un widget JavaScript embebible para agregar reproductor texto→audio a cualquier blog en 1 línea de código.

Autenticación

La API no requiere autenticación para el tier gratuito. El rate limit se aplica por IP.

Para planes Pro y Lifetime, se usa una API key enviada como header:

Authorization: Bearer tu-api-key

Obtén tu API key al suscribirte en la página de precios.

Endpoints

Método	Ruta	Descripción
`POST`	/convert/text	Texto plano → MP3 narrado
`POST`	/convert/pdf	Archivo PDF → MP3 narrado
`POST`	/convert/url	URL de artículo → MP3 narrado
`GET`	/voices	Lista de voces disponibles (México y España)
`GET`	/audio/{id}	Descargar MP3 generado por ID
`POST`	/demo/try	Demo anónimo (500 chars max)
`GET`	/stats	Estadísticas públicas del servicio
`GET`	/embed.js	Widget JS embebible para tu sitio

Ejemplos de uso

Convertir texto a audio

Envía texto en español y recibe un MP3 narrado con voz natural.

curl -X POST https://voz.4l3.org/convert/text \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "text=Hola mundo, esto es una prueba de VozAlta." \
  -d "voice=es-MX-Ald"

import requests

response = requests.post(
    "https://voz.4l3.org/convert/text",
    data={
        "text": "Hola mundo, esto es una prueba de VozAlta.",
        "voice": "es-MX-Ald",
    },
)
result = response.json()
print(result["audio_url"])  # /audio/abc123.mp3

const response = await fetch("https://voz.4l3.org/convert/text", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    text: "Hola mundo, esto es una prueba de VozAlta.",
    voice: "es-MX-Ald",
  }),
});
const { audio_url } = await response.json();
console.log(audio_url); // /audio/abc123.mp3

Respuesta:

{
  "audio_id": "abc123",
  "audio_url": "/audio/abc123.mp3",
  "duration_s": 3.2,
  "voice": "es-MX-Ald",
  "chars": 47
}

Convertir URL de artículo a audio

Extrae el texto de cualquier artículo web y genera un audio narrado.

curl -X POST https://voz.4l3.org/convert/url \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "url=https://es.wikipedia.org/wiki/Inteligencia_artificial" \
  -d "voice=es-ES-Sharvard"

import requests

response = requests.post(
    "https://voz.4l3.org/convert/url",
    data={
        "url": "https://es.wikipedia.org/wiki/Inteligencia_artificial",
        "voice": "es-ES-Sharvard",
    },
)
result = response.json()
print(f"Audio: {result['audio_url']}, Duración: {result['duration_s']}s")

const response = await fetch("https://voz.4l3.org/convert/url", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    url: "https://es.wikipedia.org/wiki/Inteligencia_artificial",
    voice: "es-ES-Sharvard",
  }),
});
const data = await response.json();
console.log(`Audio: ${data.audio_url}`);

Respuesta:

{
  "audio_id": "def456",
  "audio_url": "/audio/def456.mp3",
  "duration_s": 245.7,
  "voice": "es-ES-Sharvard",
  "chars": 12840,
  "title": "Inteligencia artificial - Wikipedia"
}

Listar voces disponibles

Obtén la lista de voces con su idioma, género y código.

curl https://voz.4l3.org/voices

import requests

voices = requests.get("https://voz.4l3.org/voices").json()
for v in voices:
    print(f"{v['id']}: {v['name']} ({v['lang']})")

const voices = await fetch("https://voz.4l3.org/voices").then(r => r.json());
voices.forEach(v => console.log(`${v.id}: ${v.name} (${v.lang})`));

Respuesta:

[
  {"id": "es-MX-Ald", "name": "Ald (México)", "lang": "es-MX", "gender": "male"},
  {"id": "es-ES-Davefx", "name": "Davefx (España)", "lang": "es-ES", "gender": "male"},
  {"id": "es-ES-Sharvard", "name": "Sharvard (España)", "lang": "es-ES", "gender": "male"}
]

Probar la API

Haz llamadas reales a la API directamente desde aqui. Sin API key necesaria para el plan gratuito.

POST /convert/text Texto a Audio

GET /voices Listar voces

Límites de uso

Free (sin registro): 5 generaciones/hora, 20/día por IP. Máximo 100,000 caracteres por texto, 20 MB por PDF.

Pro ($7/mes): Sin límite de generaciones. Prioridad en cola.

Lifetime ($49): Igual que Pro, pago único de por vida.

Todos los planes incluyen acceso a todas las voces y formatos (MP3, WAV, OGG).

SDK Python

Instala el SDK oficial y úsalo en 3 líneas:

pip install vozalta

Ejemplo:

from vozalta import VozAlta

client = VozAlta()  # Free tier, no API key needed

result = client.convert_text("Hola mundo, esto es VozAlta.")
client.download(result["audio_url"], "salida.mp3")

Paquete: vozalta · Compatible con Python 3.8+

Recursos API

Descarga la especificación para tu herramienta favorita:

OpenAPI 3.1 (JSON) Swagger UI

Compatible con Postman, Insomnia, Swagger, y cualquier cliente OpenAPI.

Empieza gratis

No necesitas API key para empezar. Simplemente haz tu primera llamada:

curl https://voz.4l3.org/api?format=json

Ir a VozAlta Ver planes

¿Prefieres JSON? Llama este URL con Accept: application/json o agrega ?format=json.