Documentación API — Elite Labs

Elite Labs API

Genera síntesis de voz de alta calidad mediante nuestra API REST. Sin suscripción, sin límites mensuales — pagas solo lo que usas.

Precio

18€ / 1M bytes

Pago

Por uso, sin cuota

Latencia

Streaming

Base URL

url

https://elitelabs.es/api/v1

Autenticación

Todas las peticiones requieren un header Authorization con tu API key. Las keys tienen el formato el_live_XXXXXXXX.

header

Authorization: Bearer el_live_YOUR_KEY

Genera tu API key en el panel de desarrollador →

Ejemplo

curl -X POST https://elitelabs.es/api/v1/tts \
  -H "Authorization: Bearer el_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hola", "voice_id": "VOICE_ID"}' \
  --output audio.mp3

Rate limits

La concurrencia máxima depende del gasto acumulado en tu wallet API. A mayor gasto histórico, más solicitudes puedes procesar en paralelo.

Gasto acumulado	Concurrencia
0 — 150€	3 slots
150 — 250€	10 slots
250 — 1.500€	40 slots
+3.000€	50 slots

Headers de respuesta

Header	Descripción
X-Bytes-Used	Bytes consumidos en esta petición
X-Bytes-Remaining	Bytes restantes en tu wallet

Errores

Código	Significado
401	API key inválida o ausente
402	Sin bytes disponibles en wallet
400	Parámetros incorrectos
500	Error interno del servidor

Formato de error

json

{ "error": "descripción del error" }

POST/v1/tts

Convierte texto a audio. Devuelve el binario de audio directamente en el body de la respuesta.

Headers

Parámetro	Tipo		Descripción
Authorization	string	requerido	Bearer el_live_YOUR_KEY
Content-Type	string	requerido	application/json

Body

Parámetro	Tipo		Descripción
text	string	requerido	Texto a sintetizar (UTF-8)
voice_id	string	requerido	ID de la voz a usar
model	string	opcional	Modelo TTS. Default: elite-e2-pro
speed	number	opcional	Velocidad 0.5–2.0. Default: 1.0
format	string	opcional	mp3 (default) \| wav

Respuesta

Audio binario en el formato especificado (Content-Type: audio/mpeg o audio/wav).

Modelos disponibles

ID	Descripción
elite-e2-pro	Motor principal S2-Pro · Máxima calidad (recomendado)
elite-legacy	Motor S1 Legacy · Compatible con etiquetas (parenthesis)
elite-turbo	Motor rápido · Menor latencia

Ejemplo

curl -X POST https://elitelabs.es/api/v1/tts \
  -H "Authorization: Bearer el_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "[excited] Bienvenido a Elite Labs.",
    "voice_id": "VOICE_ID",
    "model": "elite-e2-pro",
    "speed": 1.0,
    "format": "mp3"
  }' --output audio.mp3

GET/v1/voices

Lista las voces públicas disponibles en la plataforma.

Query params

Parámetro	Tipo		Descripción
page	number	opcional	Página. Default: 1
limit	number	opcional	Resultados por página. Default: 20, máx: 100

Respuesta

json

{
  "voices": [
    {
      "id":       "string",
      "name":     "string",
      "gender":   "masculine | feminine",
      "language": "string",
      "provider": "fish_audio"
    }
  ],
  "page":  1,
  "limit": 20,
  "total": 42
}

GET/v1/usage

Consulta el saldo disponible en tu wallet API.

Respuesta

json

{
  "bytes_available": 1000000,
  "total_spent_eur": 18.00
}

GET/v1/models

Lista los modelos disponibles y su precio.

Respuesta

json

{
  "models": [
    {
      "id":                     "elite-e2-pro",
      "name":                   "Elite Labs E2 Pro",
      "type":                   "tts",
      "price_per_million_bytes": 18
    },
    {
      "id":                     "elite-legacy",
      "name":                   "Elite Labs Legacy",
      "type":                   "tts",
      "price_per_million_bytes": 18
    },
    {
      "id":                     "elite-turbo",
      "name":                   "Elite Labs Turbo",
      "type":                   "tts",
      "price_per_million_bytes": 18
    },
    {
      "id":           "transcribe-1",
      "name":         "Elite Labs ASR",
      "type":         "asr",
      "price_per_hour": 0.36
    }
  ]
}

Primeros pasos

Empieza a generar audio en menos de 5 minutos.

Crea tu cuenta

Regístrate gratis en elitelabs.es

Recarga tu wallet

Ve al panel de desarrollador y añade saldo. Desde 18€ por 1M bytes.

Genera tu API key

En el panel de desarrollador, crea una key con un nombre descriptivo.

Haz tu primera petición

Copia el ejemplo de abajo, reemplaza YOUR_KEY y VOICE_ID y ejecuta.

Ejemplo completo

# 1. Consulta tus voces disponibles
curl https://elitelabs.es/api/v1/voices \
  -H "Authorization: Bearer el_live_YOUR_KEY"

# 2. Genera audio con una voz
curl -X POST https://elitelabs.es/api/v1/tts \
  -H "Authorization: Bearer el_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hola mundo desde Elite Labs.",
    "voice_id": "ID_DE_VOZ_COPIADO_ARRIBA",
    "model": "elite-e2-pro"
  }' --output mi_audio.mp3

# 3. Comprueba tu saldo
curl https://elitelabs.es/api/v1/usage \
  -H "Authorization: Bearer el_live_YOUR_KEY"

Modelos y precios

Los bytes se calculan sobre el texto UTF-8 de entrada, no sobre el tamaño del audio resultante. El precio es el mismo para todos los modelos TTS.

Tipo	Modelo	Precio
TTS	elite-e2-pro	18€ / millón de bytes
TTS	elite-legacy	18€ / millón de bytes
TTS	elite-turbo	18€ / millón de bytes
ASR	transcribe-1	0.36€ / hora de audio

Ejemplo: un texto de 1.000 caracteres UTF-8 ≈ 1.000 bytes → coste aproximado de 0,018€.

Etiquetas de emoción

El motor Elite E2 Pro (S2-Pro) soporta etiquetas entre corchetes que modifican el tono y la emoción. Las etiquetas deben ir al inicio de cada frase.

Tono emocional

[angry][sad][excited][whispering][soft][breathy][emphasis]

Efectos de audio

[laughing][chuckling][sighing][pause][long pause]

Avanzadas

[inhale][exhale][screaming][shouting][surprised]

Ejemplo

text

"[excited] Bienvenido a Elite Labs. [soft] Tu audio está listo."

El motor Legacy (S1) usa sintaxis con paréntesis: (happy) (sad) (angry) (excited) (whispering)

Formatos de audio

Formato	Calidad	Uso recomendado
mp3	128 kbps	Web, streaming (default)
wav	Sin pérdida	Producción, edición

Los bytes consumidos se calculan sobre el texto UTF-8 de entrada, no sobre el tamaño del audio de salida.