- Documentación
Introducción
Welcome to the documentation for Dubbix. A powerful solution designed to revolutionize the way you approach audio localization and content creation.
¿Qué contiene nuestra API v2?
Nuestra API agiliza la traducción de contenidos. Solo tienes que subir tu vídeo y obtener el resultado traducido sin esfuerzo.
Aviso de obsoleto de la API v1
La compatibilidad con la API v1 se interrumpió oficialmente tras el lanzamiento de la API v2.
Desde mayo de 2025, la API v1 está totalmente obsoleta y ya no es accesible.
Todas las integraciones deben utilizar ahora la API v2.
Limitaciones
La lista de limitaciones de la API v2
Estamos trabajando constantemente para mejorar nuestra API, sin embargo, esta es una lista de las limitaciones actuales:
1. Actualmente admitimos las siguientes formas de cargar su vídeo:
cargar mediante enlace utilizando enlaces a vídeos en Youtube, Google Drive, S3, Vimeo o un enlace de acceso directo;
carga local desde tu dispositivo.
3. Todavía no es posible generar vídeos con subtítulos a través de la API. Esta característica se añadirá en el futuro, mientras tanto, puede utilizar nuestra plataforma web para obtener una versión del vídeo traducido con subtítulos en el idioma de destino quemado en ella.
Texto a voz (TTS)
URL base:** `https://api.example.com`
Puntos finales
WebSocket /tts_stream/bytes
Punto final de transmisión de texto a voz en tiempo real que acepta la entrada de texto y transmite trozos de audio a medida que se generan.
**URL:** `ws://api.example.com/tts_stream/bytes` o `wss://api.example.com/tts_stream/bytes`.
**Protocolo:** WebSocket
#### Conexión
Establezca una conexión WebSocket con el endpoint. A cada conexión se le asigna automáticamente un ID de usuario único.
#### Formato del mensaje
Enviar mensajes JSON con la siguiente estructura:
Conversión de voz
Este punto final realiza la conversión de voz de voz a voz.
Usted proporciona:
- Un archivo de audio de referencia **(voz que quieres imitar)**
- Un archivo de audio de entrada **(contenido que quieres que se hable con esa voz)**
La API devuelve un archivo WAV convertido con el contenido de entrada pronunciado con la voz de referencia.
## Endpoint
POST /convertidor_voz/vc
## Solicitud
### Cabeceras
aceptar: application/json
Content-Type: multipart/form-data
### Parámetros de datos del formulario
reference_file (archivo, obligatorio) - Archivo de audio de referencia (.wav o .mp3) que contiene la voz de destino input_file (archivo, obligatorio) - Archivo de audio de entrada (.wav o .mp3) que contiene el contenido a convertir
## Ejemplo Solicitudes
### cURL
Enviar mensajes JSON con la siguiente estructura:
### Python (peticiones)
```python
importar peticiones
## Limitaciones:
- El archivo de audio de referencia debe durar entre 4 y 20 segundos; se recomienda entre 12 y 15 segundos.
## Notas
- Both files must be short enough for processing (recommend < 30MB each).
- Output is always returned as WAV.
- The endpoint streams the file back — remember to save the binary output.
Resumidor de audio y vídeo
Esta API le permite **cargar archivos de audio o vídeo** y recibir:
- **Transcripción** (texto del contenido hablado)
- **Sellos de tiempo** (alineados con los segmentos de la transcripción)
- **Resumen** (versión abreviada del contenido)
1. Resumir archivo de audio/vídeo
**Punto final**
aceptar: application/json
Content-Type: multipart/form-data
**Descripción**
Sube un archivo de audio o vídeo (por ejemplo, `.wav`, `.mp3`, `.mp4`) y obtén una transcripción, marcas de tiempo y un resumen específico por idioma.
## Recomendaciones de uso:
+ Always include a unique `request_id` for better tracking.
+ Keep file sizes reasonable (<100MB recommended).
Doblaje/Traducción
De voz a voz
**URL base:** `https://api.example.com`
## Endpoints
### POST /speech/translate
Traduce el habla de un idioma a otro y devuelve el audio traducido en forma de archivo WAV.