API · Modo de Uso

Modo de Uso

Aprende a usar la API de Vocea para generar audios y transcribir voz. Con ejemplos prácticos y un flujo n8n listo para importar.

1. Generar Audio (TTS)2. Transcribir Audio (STT)3. Flujo n8n

Autenticación

Todas las peticiones requieren un Bearer token. Puedes obtener tu API Key desde el panel de configuración. Cada llamada descuenta créditos de tu cuenta.

Authorization: Bearer TU_API_KEY
Base URL: https://vocea.app/api/v1

0. Obtener tu Voice ID

Antes de generar audio, obtén el UUID de tu voz clonada.

Petición

curl https://vocea.app/api/v1/voices \
  -H "Authorization: Bearer TU_API_KEY"

Respuesta

[
  {
    "id": "uuid-de-tu-voz",
    "name": "Mi Voz",
    "language": "es",
    "created_at": "2026-01-01T00:00:00Z"
  }
]

1. Generar Audio (TTS)

Convierte texto en audio usando tu voz clonada. Elige idioma, emoción y velocidad.

Campo	Tipo	Requerido	Descripción
voice_id	UUID	✅	ID de la voz clonada
text	string	✅	Texto a sintetizar (máx. 10,000 chars)
language_code	string	✅	es, en, fr, de, it, pt, zh, ja, ko, ar, hi, ru, nl, pl, he
voice_setting.emotion	string	—	neutral, happy, sad, angry, fearful, surprised, disgusted, whisper
voice_setting.speakingRate	float	—	Velocidad del habla [0.5 – 1.5]
voice_setting.temperature	float	—	Expresividad [0.01 – 2.0]

Petición

curl -X POST https://vocea.app/api/v1/audios/generate \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_id": "UUID_DE_TU_VOZ",
    "text": "Hola mundo, esto es una prueba.",
    "language_code": "es",
    "voice_setting": {
      "emotion": "happy",
      "speakingRate": 1.0
    }
  }'

Respuesta

{
  "id": "audio-uuid",
  "url": "https://cdn.vocea.app/audios/tu-audio.mp3",
  "duration": 2.4,
  "credits_used": 150,
  "created_at": "2026-04-09T12:00:00Z"
}

Probarlo en el panel →

2. Transcribir Audio (STT)

Envía un archivo de audio y recibe el texto transcrito. Soporta MP3, MP4, WAV, OGG, WebM y FLAC.

Campo	Tipo	Requerido	Descripción
audio	file (multipart)	✅	MP3, MP4/M4A, WAV, OGG, WebM, FLAC (máx. 10 MB)
language	query string	—	Código de idioma (ej: es, en)

Petición

curl -X POST https://vocea.app/api/v1/stt/transcribe \
  -H "Authorization: Bearer TU_API_KEY" \
  -F "audio=@mi-audio.mp3" \
  -G --data-urlencode "language=es"

Respuesta

{
  "text": "Hola mundo, esto es una prueba.",
  "language": "es",
  "duration": 2.4,
  "credits_used": 50
}

Probarlo en el panel →

3. Flujo n8n

Importa el flujo preconfigurado en n8n, configura tu API Key y empieza a generar audios desde cualquier webhook.

1
Descarga el archivo JSON del flujo usando el botón de abajo.
2
En tu instancia de n8n, ve a Workflows → Import from file y selecciona el JSON descargado.
3
Abre el nodo "HTTP Request" y reemplaza TU_API_KEY con tu clave de la sección de configuración.
4
Activa el flujo. Envía un POST a tu webhook con { "voice_id": "...", "text": "...", "language_code": "es" } y recibirás la URL del audio generado.

Descargar flujo n8n

Flujo n8n — Vista previa

Webhook (POST)→HTTP: Vocea API→Respond (audio URL)

← Volver al inicio