4 min de lectura Uploading Files

Enviar audio por URL y por la API

Aprende a importar audio por URL en la interfaz y a enviar transcripciones por la API: planes elegibles, claves, autenticación, límites y webhooks.

Además de la subida de archivos, hay dos vías «sin archivo a mano»: pegar una URL de medios en la interfaz (para cualquier usuario) y enviar a través de la API (para planes Profesional y superiores), ideal para integrar la transcripción con sistemas, PABX y automatizaciones.

1. Importar por URL en la interfaz

En la pantalla de Nueva transcripción, la misma opción que acepta YouTube acepta URL directas de archivos de audio/vídeo (https). El servidor descarga el medio y sigue el flujo normal: elección de idioma (o detección automática), motor del plan y coste en ciclos según la duración. Los límites de duración y tamaño de tu plan se aplican igual.

2. API de transcripción

Quién puede usarla

La API está disponible a partir del plan Profesional (R$ 39,90/mes), incluidos Premium, planes empresariales y heredados equivalentes. En otros planes, al crear una clave se devuelve que el plan no es elegible.

Claves de API

Formato del token: vpt_live_...;
El secreto se muestra una sola vez al crearlo: consérvalo en un gestor de contraseñas. No guardamos el secreto, solo una huella digital del mismo;
Hasta 20 claves activas por cuenta; puedes revocar cualquiera en cualquier momento;
El área de gestión de claves personales en la interfaz está en implementación; si no encuentras la opción en tu cuenta, abre un ticket y te la activamos.

Cómo funciona una llamada

Autenticación mediante cabecera Authorization: Bearer vpt_live_.... En el cuerpo indicas la URL del audio (audio_url, solo https), la URL de tu webhook para recibir el resultado y, opcionalmente, motor, idioma, formatos de exportación y clave de idempotencia.

Rate limit: 60 solicitudes por minuto por clave;
Tamaño: audio por URL de hasta 500 MB para descargar en el servidor; con el motor Premium, las URL de hasta 5 GB se pueden leer directamente desde el motor, sin descarga intermedia;
Coste: los mismos ciclos que en el sitio, según duración y motor.

Recibir el resultado (webhooks)

El resultado llega mediante webhook firmado con HMAC-SHA256 (cabeceras X-VPT-Signature y X-VPT-Event); valida la firma antes de confiar en el payload. Si tu endpoint está fuera de servicio, reenviamos con retroceso progresivo: hasta 6 intentos a lo largo de ~24 horas.

Solo aceptamos URL https y bloqueamos direcciones internas/privadas por seguridad. Si tu audio está detrás de autenticación, genera una URL temporal firmada en tu almacenamiento antes de llamar a la API.

¿Sin URL pública para el archivo (p. ej., grabaciones de PABX)? La API empresarial de auditoría ofrece un endpoint de subida que devuelve una URL de envío temporal (válida durante 1 hora); contacta con ventas si tu caso es auditoría de llamadas en volumen.

Preguntas frecuentes

He perdido el secreto de la clave. ¿Cómo lo recupero?

No se puede recuperar: revoca la clave y crea otra. El secreto solo existe en el momento de la creación.

¿La API tiene documentación?

La referencia completa de integración se proporciona junto con la activación del acceso. Abre un ticket indicando tu caso de uso.

¿Puedo elegir motor e idioma en la llamada?

Sí, ambos son parámetros opcionales; sin ellos, se aplican el motor estándar del plan y la detección de idioma.

¿La API cobra de forma diferente que el sitio?

No. Los mismos ciclos, las mismas reglas (incluido el descuento solo tras el éxito).

¿Cómo revoco una clave comprometida?

Revócala de inmediato en la gestión de claves (o mediante soporte). La revocación corta el acceso al momento.