Desarrolladores

Documentación de la API

Streaming por WebSocket, formatos pensados para telefonía (PCM, μ-law 8 kHz) y autenticación con una sola cabecera. Integralo en minutos.

Autenticación

Todas las requests llevan tu API key en el header X-API-Key. Generala desde tu dashboard. Se muestra una sola vez: guardala.

Síntesis en streaming

Abrí un WebSocket a /v1/tts/stream, mandá el texto y recibí frames de audio + un evento {"done": true} al final.

import asyncio, json, websockets

async def main():
    url = "wss://api.parlemos.com/v1/tts/stream"
    headers = {"X-API-Key": "plm_tu_key"}
    async with websockets.connect(url, extra_headers=headers) as ws:
        await ws.send(json.dumps({
            "voice_id": "ar_valentina",
            "text": "Hola, gracias por comunicarte.",
            "format": "pcm16",
        }))
        with open("salida.pcm", "wb") as f:
            async for msg in ws:
                if isinstance(msg, bytes):
                    f.write(msg)
                else:
                    data = json.loads(msg)
                    if data.get("done"):
                        break

asyncio.run(main())

Errores

  • auth_failed — key inválida o revocada.
  • quota_exceeded — consumiste tu cuota mensual.
  • rate_limit — demasiadas requests por minuto.
  • invalid_voice — voice_id desconocido.

¿Listo para empezar?

10.000 caracteres gratis, sin tarjeta.