GET/api/v6/tts/synthesis/{id}

Estado de una síntesis

Metadatos de una solicitud de síntesis por su id.

Alcance

API key con el servicio tts habilitado

Límite de uso

120 solicitudes por minuto

Consulta los metadatos de una solicitud de síntesis por su id, el que devuelve POST /api/v6/tts/synthesize. Solo accedes a las solicitudes de tu propia organización.

Parámetros de ruta

id

stringobligatorio

Identificador de la síntesis devuelto al sintetizar.

Respuestas

200

Metadatos de la síntesis.

{
  "success": true,
  "data": {
    "id": "01J9Z4M7K2QABCDEF5GHTV3WXY",
    "status": "completed",
    "cached": false,
    "charCount": 49,
    "durationMs": 3120,
    "language": "es-US",
    "voice": "es-us-female-2",
    "tier": "intermediate",
    "cost": "12.500000",
    "currency": "COP",
    "audioUrl": "https://storage.hablame.co/tts/9f2c...e1.wav?Expires=...&Signature=...",
    "reference": null,
    "errorCode": null,
    "createdAt": "2026-06-23 15:04:05"
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-23T15:06:10+00:00",
    "responseTimeMs": 2.3
  }
}

401

Credenciales inválidas o faltantes.

404

No existe una síntesis con ese id para tu organización.

429

Se excedió el límite de solicitudes.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

401AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.404NOT_FOUNDLa ruta que pediste no existe en esta API.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Parámetros de ruta

Respuestas

Errores posibles