Referencia Técnica de
VideoStack API

Descubre cómo integrar procesamiento de video y audio acelerado por IA en tus aplicaciones con nuestra infraestructura escalable multi-GPU.

Endpoints Síncronos: ¿Archivo o URL?

Los endpoints marcados como SÍNCRONO procesan tareas inmediatas (ej. extraer audio, descargas). Por defecto, estos endpoints devuelven el archivo resultante como una descarga directa (FileResponse).

Si prefieres recibir una URL alojada en S3 en lugar de descargar el archivo inmediatamente, puedes enviar el parámetro return_type=url en tu JSON body o como Query Param.

Por Defecto (return_type=file)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Disposition: attachment

<binary_data_stream>

Con return_type=url

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Éxito",
  "url": "https://cdn.videostack.app/..."
}

Endpoints Asíncronos: Webhooks y Polling

Los endpoints marcados como ASÍNCRONO se utilizan para tareas pesadas. La API siempre responderá de forma inmediata con un 202 Accepted y un job_id. Tienes dos formas de obtener el resultado final:

Opción 1: Webhooks (Recomendado)

Envía el parámetro webhook_url en tu petición. Cuando el trabajo termine, haremos un POST a tu URL:

{
  "job_id": "8f3a5b...",
  "status": "success",
  "output_url": "https://cdn.videostack.app/uploads/...", 
  "error": null,
  "timestamp": "2023-11-20T15:35:00Z"
}

Opción 2: Polling

Si no puedes recibir webhooks, puedes consultar repetidamente el estado de tu trabajo usando el endpoint GET /jobs/{job_id}.

Petición cURL

curl -X GET "https://api.videostack.app/jobs/8f3a5b..." \
  -H "X-API-Key: tu_api_key"

Mientras Procesa

{
  "job_id": "8f3a5b...",
  "status": "processing",
  "endpoint": "/video/dub",
  "output_url": null,
  "created_at": "..."
}

Al Finalizar

{
  "job_id": "8f3a5b...",
  "status": "success",
  "endpoint": "/video/dub",
  "output_url": "https://cdn...",
  "created_at": "..."
}

GET/SÍNCRONO

Autenticación

La API requiere autenticación mediante API Key en todos los endpoints privados. Debes incluir tu clave en el header `X-API-Key`.

Request (cURL)

curl -X GET "https://api.videostack.app/" \
  -H "X-API-Key: tu_api_key"

Response (HTTP/JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "API de Procesamiento de Video - Multi-GPU Optimizada",
  "gpus": ["NVIDIA RTX 4090"]
}

GET/health/metricsSÍNCRONO

Health & Metrics

Obtén estadísticas globales de uso de recursos, RAM, CPU y número de peticiones para monitorear tu cuota.

Request (cURL)

curl -X GET "https://api.videostack.app/health/metrics" \
  -H "X-API-Key: tu_api_key"

Response (HTTP/JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "monitoring_enabled": true,
  "total_requests": 150,
  "active_requests": 2,
  "endpoints": {
    "POST /video/join": {
      "request_count": 50,
      "ram_peak_mb": 2500.5,
      "cpu_avg_percent": 45.1
    }
  }
}

POST/uploadSÍNCRONO

Subir Archivo (Multipart)

Sube un archivo de video, audio o imagen a la nube temporal (MinIO). El archivo se guarda por 24 horas. Límite de 1GB por archivo y cuota total de 5GB por usuario.

Tip n8nCómo subir archivos desde n8n

Si el archivo proviene de un paso anterior (por ejemplo, un nodo HTTP que descargó un video o audio), n8n guarda esa información binaria en una propiedad, comúnmente llamada data.

Para enviar ese archivo a nuestro servidor, configura el nodo HTTP Request así:

Method: POST
URL: https://api.videostack.app/upload
Send Body: Actívalo (True)
Body Content Type: Multipart-Form Data
Send Binary Data: Actívalo (esto le dice a n8n que adjunte el archivo).
Binary Property: Escribe data (o el nombre de la propiedad donde el nodo anterior guardó el archivo).
Form Data Property Name (o Input Data Field Name): Escribe exactamente file. Este es el nombre del parámetro que espera nuestra API.
No olvides agregar tus Headers con el X-API-Key.

Al ejecutarse, n8n tomará el archivo descargado de la memoria y lo enviará correctamente usando el campo 'file'. Obtendrás un JSON con la URL lista para usar en los demás endpoints.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
file	file (multipart/form-data)	-	El archivo binario a subir.

Request (cURL)

curl -X POST "https://api.videostack.app/upload" \
  -H "X-API-Key: tu_api_key" \
  -F "file=@ruta/a/tu/archivo.mp4"

Response (HTTP/JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "file_id": "8f3a5b...",
  "filename": "archivo.mp4",
  "url": "https://cdn.videostack.app/uploads/archivo.mp4?AWSAccessKeyId=AKIA...&Expires=1700494200&Signature=...",
  "size_bytes": 104857600,
  "expires_at": "2023-11-20T15:30:00Z"
}

GET/mediaSÍNCRONO

Listar Archivos Activos

Devuelve la lista de archivos activos subidos en las últimas 24 horas y que aún ocupan cuota de almacenamiento.

Request (cURL)

curl -X GET "https://api.videostack.app/media" \
  -H "X-API-Key: tu_api_key"

Response (HTTP/JSON)

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "file_id": "8f3a5b...",
    "filename": "archivo.mp4",
    "url": "https://cdn.videostack.app/uploads/archivo.mp4?AWSAccessKeyId=AKIA...&Expires=1700494200&Signature=...",
    "size_bytes": 104857600,
    "created_at": "2023-11-19T15:30:00Z",
    "expires_at": "2023-11-20T15:30:00Z"
  }
]

DELETE/media/{file_id}SÍNCRONO

Eliminar Archivo

Elimina un archivo subido antes de que pasen sus 24 horas, útil para liberar espacio en la cuota de 5GB.

Request (cURL)

curl -X DELETE "https://api.videostack.app/media/8f3a5b..." \
  -H "X-API-Key: tu_api_key"

Response (HTTP/JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "deleted",
  "file_id": "8f3a5b..."
}

POST/subtitles/generateASÍNCRONO (WEBHOOK)

Generar Subtítulos Animados

Genera subtítulos automáticos ultra rápidos usando Whisper V3 y los incrusta en el video con efectos altamente personalizables.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_url	string	-	URL pública del video original.
style_options.effect	string	karaoke_fill	Efectos soportados: simple_srt, highlight_word_by_word, karaoke_fill, fade_per_line, zoom_in_word, slide_up_line, gentle_popup_line, typewriter_word, zoom_and_highlight_word, multi_color_highlight, multi_color_zoom_highlight, neon_highlight_word, neon_zoom_highlight_word
style_options.max_words_per_line	number	5	Límite de palabras mostradas simultáneamente.
style_options.font_name	string	Arial	Nombre de la fuente (debe estar instalada en servidor).
style_options.font_size	number	60	Tamaño de la fuente.
style_options.primary_color	string	#FFFFFF	Color principal en formato HEX.
style_options.secondary_color	string	#808080	Color secundario para palabras pasadas o inactivas.
style_options.position_alignment	number	2	Alineación usando teclado numérico (2 = Centro abajo, 5 = Centro medio, 8 = Centro arriba).

Request (cURL)

curl -X POST "https://api.videostack.app/subtitles/generate" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_url": "https://example.com/video.mp4",
    "style_options": {
      "effect": "neon_zoom_highlight_word",
      "font_size": 75,
      "primary_color": "#00FFFF",
      "secondary_color": "#FF00FF"
    }
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/transcribeASÍNCRONO (WEBHOOK)

Transcribir Video

Extrae el texto de un video directo o de YouTube de forma inteligente, retornando JSON, SRT, VTT o Texto plano.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_url	string	-	URL del video (MP4) o link de YouTube.
language	string	auto	Código de idioma (ej: es, en).
output_format	string	json	json, text, srt, vtt.
include_timestamps	boolean	true	Incluye marcas de tiempo por segmento.
include_word_timestamps	boolean	false	Incluye marcas de tiempo a nivel de palabra individual.

Request (cURL)

curl -X POST "https://api.videostack.app/transcribe" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_url": "https://youtube.com/watch?v=12345",
    "language": "es",
    "output_format": "json",
    "include_word_timestamps": true
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/subtitles/translateSÍNCRONO

Traducir Transcripción

Transcribe el video y automáticamente traduce los subtítulos al idioma destino.

Idiomas de Traducción Soportados

La API de traducción utiliza los códigos de idioma estándar ISO-639-1. A continuación se muestran los idiomas más comunes.

Soporta virtualmente todos los idiomas globales de Google Translate.

es (Español)

en (Inglés)

fr (Francés)

de (Alemán)

it (Italiano)

pt (Portugués)

zh-CN (Chino)

ja (Japonés)

ru (Ruso)

ar (Árabe)

ko (Coreano)

hi (Hindi)

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
video_url	string	-	URL del video original.
target_lang	string	en	Idioma destino (ej: en, fr, de).

Request (cURL)

curl -X POST "https://api.videostack.app/subtitles/translate" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/spanish_video.mp4",
    "target_lang": "en"
  }'

Response (HTTP/JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "text": "Hello everyone, welcome to the tutorial...",
  "segments": [
    { "start": 0.0, "end": 3.5, "text": "Hello everyone, welcome to the tutorial" }
  ]
}

POST/video/joinASÍNCRONO (WEBHOOK)

Fusión Masiva de Videos

Une múltiples clips de video normalizando el audio y aplicando transiciones suaves entre ellos. Gestiona automáticamente la RAM (Batch Processing) para videos pesados.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_urls	string[]	-	Array de URLs de los videos (mínimo 2).
transition_options.global_effect	string	fade	fade, fadeblack, fadewhite, distance, wipeleft, wiperight, wipeup, wipedown, slideleft, slideright, circlecrop, rectcrop, dissolve, pixelize, radial, hblur, diagtl, diagtr.
transition_options.duration	number	1.0	Duración de la transición en segundos.

Request (cURL)

curl -X POST "https://api.videostack.app/video/join" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_urls": [
      "https://example.com/clip1.mp4",
      "https://example.com/clip2.mp4"
    ],
    "transition_options": {
      "global_effect": "fadeblack",
      "duration": 1.5
    }
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/video/editSÍNCRONO

Edición Genérica (FFmpeg)

Libertad total. Envía comandos FFmpeg crudos para aplicar filtros complejos de video y audio. Soporta sintaxis de duración dinámica ('T').

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
video_url	string	-	URL del video.
audio_url	string	-	(Opcional) URL de audio adicional.
commands	object[]	-	Array de pares {option, value}. Usa 'T' en el value para referenciar la duración total (ej: 'T-5').

Opción 1: Descarga Directa (Por defecto)

Request (cURL)

curl -X POST "https://api.videostack.app/video/edit" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "commands": [
      {"option": "-vf", "value": "scale=1920:1080,fps=30"},
      {"option": "-c:v", "value": "libx264"},
      {"option": "-preset", "value": "veryfast"}
    ]
  }'

Response (Binario)

HTTP/1.1 200 OK
Content-Type: video/mp4
Content-Disposition: attachment; filename="output.mp4"
Content-Length: 12053412

<binary_data>

Opción 2: Obtener URL S3 (?return_type=url)

Request (cURL)

curl -X POST "https://api.videostack.app/video/edit?return_type=url" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "commands": [
      {"option": "-vf", "value": "scale=1920:1080,fps=30"},
      {"option": "-c:v", "value": "libx264"},
      {"option": "-preset", "value": "veryfast"}
    ]
  }'

Response (JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Video editado",
  "url": "https://cdn.videostack.app/uploads/..."
}

POST/video/jumpcutASÍNCRONO (WEBHOOK)

Jumpcut Automático (Silencios)

Analiza el audio del video y elimina automáticamente los silencios, ideal para vlogs, podcasts o tutoriales para retener audiencia.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_url	string	-	URL del video.
silence_db	string	-30dB	Umbral de ruido para considerar silencio.
silence_duration	number	0.5	Duración mínima en segundos para cortar.
padding	number	0.2	Margen de seguridad (seg) alrededor de los cortes para evitar voces cortadas.

Request (cURL)

curl -X POST "https://api.videostack.app/video/jumpcut" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_url": "https://example.com/podcast.mp4",
    "silence_db": "-35dB",
    "silence_duration": 0.8,
    "padding": 0.25
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/video/smartcropASÍNCRONO (WEBHOOK)

Smart Crop (TikTok/Reels)

Recorta un video horizontal (16:9) al formato vertical (9:16) desenfocando los bordes u optimizando el encuadre central automáticamente.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_url	string	-	URL del video horizontal.

Request (cURL)

curl -X POST "https://api.videostack.app/video/smartcrop" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_url": "https://example.com/horizontal_video.mp4"
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/video/clipSÍNCRONO

Extraer Clip de Video

Extrae un segmento específico de un video usando tiempos exactos sin recodificar (cuando es posible) para máxima velocidad.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
video_url	string	-	URL del video.
start_time	string	-	Tiempo de inicio (ej: '00:01:20' o '80').
end_time	string	-	Tiempo de fin (ej: '00:02:00' o '120').

Opción 1: Descarga Directa (Por defecto)

Request (cURL)

curl -X POST "https://api.videostack.app/video/clip" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "start_time": "00:00:15",
    "end_time": "00:00:45"
  }'

Response (Binario)

HTTP/1.1 200 OK
Content-Type: video/mp4
Content-Disposition: attachment; filename="clip.mp4"
Content-Length: 450321

<binary_data>

Opción 2: Obtener URL S3 (?return_type=url)

Request (cURL)

curl -X POST "https://api.videostack.app/video/clip?return_type=url" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "start_time": "00:00:15",
    "end_time": "00:00:45"
  }'

Response (JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Video recortado",
  "url": "https://cdn.videostack.app/uploads/..."
}

POST/video/thumbnailSÍNCRONO

Generar Miniatura

Extrae un fotograma exacto del video para usarlo como miniatura o portada (JPEG).

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
video_url	string	-	URL del video.
timestamp	string	00:00:01	Marca de tiempo del fotograma a extraer.

Opción 1: Descarga Directa (Por defecto)

Request (cURL)

curl -X POST "https://api.videostack.app/video/thumbnail" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "timestamp": "00:01:30"
  }'

Response (Binario)

HTTP/1.1 200 OK
Content-Type: image/jpeg
Content-Disposition: attachment; filename="thumbnail.jpg"
Content-Length: 204561

<binary_data>

Opción 2: Obtener URL S3 (?return_type=url)

Request (cURL)

curl -X POST "https://api.videostack.app/video/thumbnail?return_type=url" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4",
    "timestamp": "00:01:30"
  }'

Response (JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Miniatura generada",
  "url": "https://cdn.videostack.app/uploads/..."
}

POST/video/watermarkASÍNCRONO (WEBHOOK)

Añadir Marca de Agua

Superpone una imagen (logo) sobre el video en una posición específica.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_url	string	-	URL del video.
image_url	string	-	URL de la imagen (PNG transparente ideal).
position	string	bottom-right	top-left, top-right, bottom-left, bottom-right, center.

Request (cURL)

curl -X POST "https://api.videostack.app/video/watermark" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_url": "https://example.com/video.mp4",
    "image_url": "https://example.com/logo.png",
    "position": "top-left"
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/video/compressASÍNCRONO (WEBHOOK)

Compresión Masiva

Reduce dramáticamente el tamaño del archivo de video optimizando su resolución y bitrate mediante codificación de hardware (QSV/NVENC).

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_url	string	-	URL del video pesado.
resolution	string	720	Resolución vertical máxima (1080, 720, 480).
crf	string	28	Constant Rate Factor (Calidad). Menor valor = Más calidad/peso. (23 a 28 es óptimo).

Request (cURL)

curl -X POST "https://api.videostack.app/video/compress" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_url": "https://example.com/heavy_4k.mp4",
    "resolution": "720",
    "crf": "26"
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/audio/extractSÍNCRONO

Extraer Audio

Separa y exporta la pista de audio de cualquier archivo de video sin pérdida de calidad (copia directa del codec).

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
video_url	string	-	URL del video.

Opción 1: Descarga Directa (Por defecto)

Request (cURL)

curl -X POST "https://api.videostack.app/audio/extract" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4"
  }'

Response (Binario)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Disposition: attachment; filename="audio.mp3"
Content-Length: 4501230

<binary_data>

Opción 2: Obtener URL S3 (?return_type=url)

Request (cURL)

curl -X POST "https://api.videostack.app/audio/extract?return_type=url" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://example.com/video.mp4"
  }'

Response (JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Audio extraído",
  "url": "https://cdn.videostack.app/uploads/..."
}

POST/audio/enhance

Limpiar y Mejorar Audio (IA)

Aplica reducción de ruido, normalización de volumen, compresión y ecualización paramétrica para dar un tono de 'estudio' a voces caseras.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
audio_url	string	-	URL del audio o video de origen.

Opción 1: Descarga Directa (Por defecto)

Request (cURL)

curl -X POST "https://api.videostack.app/audio/enhance" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/voice_memo.mp3"
  }'

Response (Binario)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Disposition: attachment; filename="enhanced_audio.mp3"
Content-Length: 3501230

<binary_data>

Opción 2: Obtener URL S3 (?return_type=url)

Request (cURL)

curl -X POST "https://api.videostack.app/audio/enhance?return_type=url" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/voice_memo.mp3"
  }'

Response (JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Audio mejorado",
  "url": "https://cdn.videostack.app/uploads/..."
}

POST/audio/ttsSÍNCRONO

Texto a Voz (TTS)

Genera audio de alta calidad a partir de texto usando redes neuronales profundas de Edge TTS.

Catálogo de Voces e Idiomas Soportados

La API soporta traducciones a más de 100 idiomas (código ISO-639-1) y síntesis de voz con redes neuronales. Aquí listamos las voces de mayor calidad para los idiomas más populares.

Español (es) 🇪🇸 🇲🇽

es-ES-AlvaroNeural (M)
es-ES-ElviraNeural (F)
es-MX-DaliaNeural (F)
es-MX-JorgeNeural (M)

Inglés (en) 🇺🇸 🇬🇧

en-US-AriaNeural (F)
en-US-GuyNeural (M)
en-GB-SoniaNeural (F)
en-GB-RyanNeural (M)

Francés (fr) 🇫🇷

fr-FR-DeniseNeural (F)
fr-FR-HenriNeural (M)

Alemán (de) 🇩🇪

de-DE-KatjaNeural (F)
de-DE-ConradNeural (M)

Italiano (it) 🇮🇹

it-IT-IsabellaNeural (F)
it-IT-DiegoNeural (M)

Portugués (pt) 🇧🇷 🇵🇹

pt-BR-FranciscaNeural (F)
pt-BR-AntonioNeural (M)
pt-PT-DuarteNeural (M)

Ver catálogo completo de 322 voces soportadas

ID de la Voz (API)	Género	Idioma / Región
af-ZA-AdriNeural	♀ Mujer	af-ZA
af-ZA-WillemNeural	♂ Hombre	af-ZA
am-ET-AmehaNeural	♂ Hombre	am-ET
am-ET-MekdesNeural	♀ Mujer	am-ET
ar-AE-FatimaNeural	♀ Mujer	ar-AE
ar-AE-HamdanNeural	♂ Hombre	ar-AE
ar-BH-AliNeural	♂ Hombre	ar-BH
ar-BH-LailaNeural	♀ Mujer	ar-BH
ar-DZ-AminaNeural	♀ Mujer	ar-DZ
ar-DZ-IsmaelNeural	♂ Hombre	ar-DZ
ar-EG-SalmaNeural	♀ Mujer	ar-EG
ar-EG-ShakirNeural	♂ Hombre	ar-EG
ar-IQ-BasselNeural	♂ Hombre	ar-IQ
ar-IQ-RanaNeural	♀ Mujer	ar-IQ
ar-JO-SanaNeural	♀ Mujer	ar-JO
ar-JO-TaimNeural	♂ Hombre	ar-JO
ar-KW-FahedNeural	♂ Hombre	ar-KW
ar-KW-NouraNeural	♀ Mujer	ar-KW
ar-LB-LaylaNeural	♀ Mujer	ar-LB
ar-LB-RamiNeural	♂ Hombre	ar-LB
ar-LY-ImanNeural	♀ Mujer	ar-LY
ar-LY-OmarNeural	♂ Hombre	ar-LY
ar-MA-JamalNeural	♂ Hombre	ar-MA
ar-MA-MounaNeural	♀ Mujer	ar-MA
ar-OM-AbdullahNeural	♂ Hombre	ar-OM
ar-OM-AyshaNeural	♀ Mujer	ar-OM
ar-QA-AmalNeural	♀ Mujer	ar-QA
ar-QA-MoazNeural	♂ Hombre	ar-QA
ar-SA-HamedNeural	♂ Hombre	ar-SA
ar-SA-ZariyahNeural	♀ Mujer	ar-SA
ar-SY-AmanyNeural	♀ Mujer	ar-SY
ar-SY-LaithNeural	♂ Hombre	ar-SY
ar-TN-HediNeural	♂ Hombre	ar-TN
ar-TN-ReemNeural	♀ Mujer	ar-TN
ar-YE-MaryamNeural	♀ Mujer	ar-YE
ar-YE-SalehNeural	♂ Hombre	ar-YE
az-AZ-BabekNeural	♂ Hombre	az-AZ
az-AZ-BanuNeural	♀ Mujer	az-AZ
bg-BG-BorislavNeural	♂ Hombre	bg-BG
bg-BG-KalinaNeural	♀ Mujer	bg-BG
bn-BD-NabanitaNeural	♀ Mujer	bn-BD
bn-BD-PradeepNeural	♂ Hombre	bn-BD
bn-IN-BashkarNeural	♂ Hombre	bn-IN
bn-IN-TanishaaNeural	♀ Mujer	bn-IN
bs-BA-GoranNeural	♂ Hombre	bs-BA
bs-BA-VesnaNeural	♀ Mujer	bs-BA
ca-ES-EnricNeural	♂ Hombre	ca-ES
ca-ES-JoanaNeural	♀ Mujer	ca-ES
cs-CZ-AntoninNeural	♂ Hombre	cs-CZ
cs-CZ-VlastaNeural	♀ Mujer	cs-CZ
cy-GB-AledNeural	♂ Hombre	cy-GB
cy-GB-NiaNeural	♀ Mujer	cy-GB
da-DK-ChristelNeural	♀ Mujer	da-DK
da-DK-JeppeNeural	♂ Hombre	da-DK
de-AT-IngridNeural	♀ Mujer	de-AT
de-AT-JonasNeural	♂ Hombre	de-AT
de-CH-JanNeural	♂ Hombre	de-CH
de-CH-LeniNeural	♀ Mujer	de-CH
de-DE-AmalaNeural	♀ Mujer	de-DE
de-DE-ConradNeural	♂ Hombre	de-DE
de-DE-FlorianMultilingualNeural	♂ Hombre	de-DE
de-DE-KatjaNeural	♀ Mujer	de-DE
de-DE-KillianNeural	♂ Hombre	de-DE
de-DE-SeraphinaMultilingualNeural	♀ Mujer	de-DE
el-GR-AthinaNeural	♀ Mujer	el-GR
el-GR-NestorasNeural	♂ Hombre	el-GR
en-AU-NatashaNeural	♀ Mujer	en-AU
en-AU-WilliamMultilingualNeural	♂ Hombre	en-AU
en-CA-ClaraNeural	♀ Mujer	en-CA
en-CA-LiamNeural	♂ Hombre	en-CA
en-GB-LibbyNeural	♀ Mujer	en-GB
en-GB-MaisieNeural	♀ Mujer	en-GB
en-GB-RyanNeural	♂ Hombre	en-GB
en-GB-SoniaNeural	♀ Mujer	en-GB
en-GB-ThomasNeural	♂ Hombre	en-GB
en-HK-SamNeural	♂ Hombre	en-HK
en-HK-YanNeural	♀ Mujer	en-HK
en-IE-ConnorNeural	♂ Hombre	en-IE
en-IE-EmilyNeural	♀ Mujer	en-IE
en-IN-NeerjaExpressiveNeural	♀ Mujer	en-IN
en-IN-NeerjaNeural	♀ Mujer	en-IN
en-IN-PrabhatNeural	♂ Hombre	en-IN
en-KE-AsiliaNeural	♀ Mujer	en-KE
en-KE-ChilembaNeural	♂ Hombre	en-KE
en-NG-AbeoNeural	♂ Hombre	en-NG
en-NG-EzinneNeural	♀ Mujer	en-NG
en-NZ-MitchellNeural	♂ Hombre	en-NZ
en-NZ-MollyNeural	♀ Mujer	en-NZ
en-PH-JamesNeural	♂ Hombre	en-PH
en-PH-RosaNeural	♀ Mujer	en-PH
en-SG-LunaNeural	♀ Mujer	en-SG
en-SG-WayneNeural	♂ Hombre	en-SG
en-TZ-ElimuNeural	♂ Hombre	en-TZ
en-TZ-ImaniNeural	♀ Mujer	en-TZ
en-US-AnaNeural	♀ Mujer	en-US
en-US-AndrewMultilingualNeural	♂ Hombre	en-US
en-US-AndrewNeural	♂ Hombre	en-US
en-US-AriaNeural	♀ Mujer	en-US
en-US-AvaMultilingualNeural	♀ Mujer	en-US
en-US-AvaNeural	♀ Mujer	en-US
en-US-BrianMultilingualNeural	♂ Hombre	en-US
en-US-BrianNeural	♂ Hombre	en-US
en-US-ChristopherNeural	♂ Hombre	en-US
en-US-EmmaMultilingualNeural	♀ Mujer	en-US
en-US-EmmaNeural	♀ Mujer	en-US
en-US-EricNeural	♂ Hombre	en-US
en-US-GuyNeural	♂ Hombre	en-US
en-US-JennyNeural	♀ Mujer	en-US
en-US-MichelleNeural	♀ Mujer	en-US
en-US-RogerNeural	♂ Hombre	en-US
en-US-SteffanNeural	♂ Hombre	en-US
en-ZA-LeahNeural	♀ Mujer	en-ZA
en-ZA-LukeNeural	♂ Hombre	en-ZA
es-AR-ElenaNeural	♀ Mujer	es-AR
es-AR-TomasNeural	♂ Hombre	es-AR
es-BO-MarceloNeural	♂ Hombre	es-BO
es-BO-SofiaNeural	♀ Mujer	es-BO
es-CL-CatalinaNeural	♀ Mujer	es-CL
es-CL-LorenzoNeural	♂ Hombre	es-CL
es-CO-GonzaloNeural	♂ Hombre	es-CO
es-CO-SalomeNeural	♀ Mujer	es-CO
es-CR-JuanNeural	♂ Hombre	es-CR
es-CR-MariaNeural	♀ Mujer	es-CR
es-CU-BelkysNeural	♀ Mujer	es-CU
es-CU-ManuelNeural	♂ Hombre	es-CU
es-DO-EmilioNeural	♂ Hombre	es-DO
es-DO-RamonaNeural	♀ Mujer	es-DO
es-EC-AndreaNeural	♀ Mujer	es-EC
es-EC-LuisNeural	♂ Hombre	es-EC
es-ES-AlvaroNeural	♂ Hombre	es-ES
es-ES-ElviraNeural	♀ Mujer	es-ES
es-ES-XimenaNeural	♀ Mujer	es-ES
es-GQ-JavierNeural	♂ Hombre	es-GQ
es-GQ-TeresaNeural	♀ Mujer	es-GQ
es-GT-AndresNeural	♂ Hombre	es-GT
es-GT-MartaNeural	♀ Mujer	es-GT
es-HN-CarlosNeural	♂ Hombre	es-HN
es-HN-KarlaNeural	♀ Mujer	es-HN
es-MX-DaliaNeural	♀ Mujer	es-MX
es-MX-JorgeNeural	♂ Hombre	es-MX
es-NI-FedericoNeural	♂ Hombre	es-NI
es-NI-YolandaNeural	♀ Mujer	es-NI
es-PA-MargaritaNeural	♀ Mujer	es-PA
es-PA-RobertoNeural	♂ Hombre	es-PA
es-PE-AlexNeural	♂ Hombre	es-PE
es-PE-CamilaNeural	♀ Mujer	es-PE
es-PR-KarinaNeural	♀ Mujer	es-PR
es-PR-VictorNeural	♂ Hombre	es-PR
es-PY-MarioNeural	♂ Hombre	es-PY
es-PY-TaniaNeural	♀ Mujer	es-PY
es-SV-LorenaNeural	♀ Mujer	es-SV
es-SV-RodrigoNeural	♂ Hombre	es-SV
es-US-AlonsoNeural	♂ Hombre	es-US
es-US-PalomaNeural	♀ Mujer	es-US
es-UY-MateoNeural	♂ Hombre	es-UY
es-UY-ValentinaNeural	♀ Mujer	es-UY
es-VE-PaolaNeural	♀ Mujer	es-VE
es-VE-SebastianNeural	♂ Hombre	es-VE
et-EE-AnuNeural	♀ Mujer	et-EE
et-EE-KertNeural	♂ Hombre	et-EE
fa-IR-DilaraNeural	♀ Mujer	fa-IR
fa-IR-FaridNeural	♂ Hombre	fa-IR
fi-FI-HarriNeural	♂ Hombre	fi-FI
fi-FI-NooraNeural	♀ Mujer	fi-FI
fil-PH-AngeloNeural	♂ Hombre	fil-PH
fil-PH-BlessicaNeural	♀ Mujer	fil-PH
fr-BE-CharlineNeural	♀ Mujer	fr-BE
fr-BE-GerardNeural	♂ Hombre	fr-BE
fr-CA-AntoineNeural	♂ Hombre	fr-CA
fr-CA-JeanNeural	♂ Hombre	fr-CA
fr-CA-SylvieNeural	♀ Mujer	fr-CA
fr-CA-ThierryNeural	♂ Hombre	fr-CA
fr-CH-ArianeNeural	♀ Mujer	fr-CH
fr-CH-FabriceNeural	♂ Hombre	fr-CH
fr-FR-DeniseNeural	♀ Mujer	fr-FR
fr-FR-EloiseNeural	♀ Mujer	fr-FR
fr-FR-HenriNeural	♂ Hombre	fr-FR
fr-FR-RemyMultilingualNeural	♂ Hombre	fr-FR
fr-FR-VivienneMultilingualNeural	♀ Mujer	fr-FR
ga-IE-ColmNeural	♂ Hombre	ga-IE
ga-IE-OrlaNeural	♀ Mujer	ga-IE
gl-ES-RoiNeural	♂ Hombre	gl-ES
gl-ES-SabelaNeural	♀ Mujer	gl-ES
gu-IN-DhwaniNeural	♀ Mujer	gu-IN
gu-IN-NiranjanNeural	♂ Hombre	gu-IN
he-IL-AvriNeural	♂ Hombre	he-IL
he-IL-HilaNeural	♀ Mujer	he-IL
hi-IN-MadhurNeural	♂ Hombre	hi-IN
hi-IN-SwaraNeural	♀ Mujer	hi-IN
hr-HR-GabrijelaNeural	♀ Mujer	hr-HR
hr-HR-SreckoNeural	♂ Hombre	hr-HR
hu-HU-NoemiNeural	♀ Mujer	hu-HU
hu-HU-TamasNeural	♂ Hombre	hu-HU
id-ID-ArdiNeural	♂ Hombre	id-ID
id-ID-GadisNeural	♀ Mujer	id-ID
is-IS-GudrunNeural	♀ Mujer	is-IS
is-IS-GunnarNeural	♂ Hombre	is-IS
it-IT-DiegoNeural	♂ Hombre	it-IT
it-IT-ElsaNeural	♀ Mujer	it-IT
it-IT-GiuseppeMultilingualNeural	♂ Hombre	it-IT
it-IT-IsabellaNeural	♀ Mujer	it-IT
iu-Cans-CA-SiqiniqNeural	♀ Mujer	iu-Cans
iu-Cans-CA-TaqqiqNeural	♂ Hombre	iu-Cans
iu-Latn-CA-SiqiniqNeural	♀ Mujer	iu-Latn
iu-Latn-CA-TaqqiqNeural	♂ Hombre	iu-Latn
ja-JP-KeitaNeural	♂ Hombre	ja-JP
ja-JP-NanamiNeural	♀ Mujer	ja-JP
jv-ID-DimasNeural	♂ Hombre	jv-ID
jv-ID-SitiNeural	♀ Mujer	jv-ID
ka-GE-EkaNeural	♀ Mujer	ka-GE
ka-GE-GiorgiNeural	♂ Hombre	ka-GE
kk-KZ-AigulNeural	♀ Mujer	kk-KZ
kk-KZ-DauletNeural	♂ Hombre	kk-KZ
km-KH-PisethNeural	♂ Hombre	km-KH
km-KH-SreymomNeural	♀ Mujer	km-KH
kn-IN-GaganNeural	♂ Hombre	kn-IN
kn-IN-SapnaNeural	♀ Mujer	kn-IN
ko-KR-HyunsuMultilingualNeural	♂ Hombre	ko-KR
ko-KR-InJoonNeural	♂ Hombre	ko-KR
ko-KR-SunHiNeural	♀ Mujer	ko-KR
lo-LA-ChanthavongNeural	♂ Hombre	lo-LA
lo-LA-KeomanyNeural	♀ Mujer	lo-LA
lt-LT-LeonasNeural	♂ Hombre	lt-LT
lt-LT-OnaNeural	♀ Mujer	lt-LT
lv-LV-EveritaNeural	♀ Mujer	lv-LV
lv-LV-NilsNeural	♂ Hombre	lv-LV
mk-MK-AleksandarNeural	♂ Hombre	mk-MK
mk-MK-MarijaNeural	♀ Mujer	mk-MK
ml-IN-MidhunNeural	♂ Hombre	ml-IN
ml-IN-SobhanaNeural	♀ Mujer	ml-IN
mn-MN-BataaNeural	♂ Hombre	mn-MN
mn-MN-YesuiNeural	♀ Mujer	mn-MN
mr-IN-AarohiNeural	♀ Mujer	mr-IN
mr-IN-ManoharNeural	♂ Hombre	mr-IN
ms-MY-OsmanNeural	♂ Hombre	ms-MY
ms-MY-YasminNeural	♀ Mujer	ms-MY
mt-MT-GraceNeural	♀ Mujer	mt-MT
mt-MT-JosephNeural	♂ Hombre	mt-MT
my-MM-NilarNeural	♀ Mujer	my-MM
my-MM-ThihaNeural	♂ Hombre	my-MM
nb-NO-FinnNeural	♂ Hombre	nb-NO
nb-NO-PernilleNeural	♀ Mujer	nb-NO
ne-NP-HemkalaNeural	♀ Mujer	ne-NP
ne-NP-SagarNeural	♂ Hombre	ne-NP
nl-BE-ArnaudNeural	♂ Hombre	nl-BE
nl-BE-DenaNeural	♀ Mujer	nl-BE
nl-NL-ColetteNeural	♀ Mujer	nl-NL
nl-NL-FennaNeural	♀ Mujer	nl-NL
nl-NL-MaartenNeural	♂ Hombre	nl-NL
pl-PL-MarekNeural	♂ Hombre	pl-PL
pl-PL-ZofiaNeural	♀ Mujer	pl-PL
ps-AF-GulNawazNeural	♂ Hombre	ps-AF
ps-AF-LatifaNeural	♀ Mujer	ps-AF
pt-BR-AntonioNeural	♂ Hombre	pt-BR
pt-BR-FranciscaNeural	♀ Mujer	pt-BR
pt-BR-ThalitaMultilingualNeural	♀ Mujer	pt-BR
pt-PT-DuarteNeural	♂ Hombre	pt-PT
pt-PT-RaquelNeural	♀ Mujer	pt-PT
ro-RO-AlinaNeural	♀ Mujer	ro-RO
ro-RO-EmilNeural	♂ Hombre	ro-RO
ru-RU-DmitryNeural	♂ Hombre	ru-RU
ru-RU-SvetlanaNeural	♀ Mujer	ru-RU
si-LK-SameeraNeural	♂ Hombre	si-LK
si-LK-ThiliniNeural	♀ Mujer	si-LK
sk-SK-LukasNeural	♂ Hombre	sk-SK
sk-SK-ViktoriaNeural	♀ Mujer	sk-SK
sl-SI-PetraNeural	♀ Mujer	sl-SI
sl-SI-RokNeural	♂ Hombre	sl-SI
so-SO-MuuseNeural	♂ Hombre	so-SO
so-SO-UbaxNeural	♀ Mujer	so-SO
sq-AL-AnilaNeural	♀ Mujer	sq-AL
sq-AL-IlirNeural	♂ Hombre	sq-AL
sr-RS-NicholasNeural	♂ Hombre	sr-RS
sr-RS-SophieNeural	♀ Mujer	sr-RS
su-ID-JajangNeural	♂ Hombre	su-ID
su-ID-TutiNeural	♀ Mujer	su-ID
sv-SE-MattiasNeural	♂ Hombre	sv-SE
sv-SE-SofieNeural	♀ Mujer	sv-SE
sw-KE-RafikiNeural	♂ Hombre	sw-KE
sw-KE-ZuriNeural	♀ Mujer	sw-KE
sw-TZ-DaudiNeural	♂ Hombre	sw-TZ
sw-TZ-RehemaNeural	♀ Mujer	sw-TZ
ta-IN-PallaviNeural	♀ Mujer	ta-IN
ta-IN-ValluvarNeural	♂ Hombre	ta-IN
ta-LK-KumarNeural	♂ Hombre	ta-LK
ta-LK-SaranyaNeural	♀ Mujer	ta-LK
ta-MY-KaniNeural	♀ Mujer	ta-MY
ta-MY-SuryaNeural	♂ Hombre	ta-MY
ta-SG-AnbuNeural	♂ Hombre	ta-SG
ta-SG-VenbaNeural	♀ Mujer	ta-SG
te-IN-MohanNeural	♂ Hombre	te-IN
te-IN-ShrutiNeural	♀ Mujer	te-IN
th-TH-NiwatNeural	♂ Hombre	th-TH
th-TH-PremwadeeNeural	♀ Mujer	th-TH
tr-TR-AhmetNeural	♂ Hombre	tr-TR
tr-TR-EmelNeural	♀ Mujer	tr-TR
uk-UA-OstapNeural	♂ Hombre	uk-UA
uk-UA-PolinaNeural	♀ Mujer	uk-UA
ur-IN-GulNeural	♀ Mujer	ur-IN
ur-IN-SalmanNeural	♂ Hombre	ur-IN
ur-PK-AsadNeural	♂ Hombre	ur-PK
ur-PK-UzmaNeural	♀ Mujer	ur-PK
uz-UZ-MadinaNeural	♀ Mujer	uz-UZ
uz-UZ-SardorNeural	♂ Hombre	uz-UZ
vi-VN-HoaiMyNeural	♀ Mujer	vi-VN
vi-VN-NamMinhNeural	♂ Hombre	vi-VN
zh-CN-XiaoxiaoNeural	♀ Mujer	zh-CN
zh-CN-XiaoyiNeural	♀ Mujer	zh-CN
zh-CN-YunjianNeural	♂ Hombre	zh-CN
zh-CN-YunxiNeural	♂ Hombre	zh-CN
zh-CN-YunxiaNeural	♂ Hombre	zh-CN
zh-CN-YunyangNeural	♂ Hombre	zh-CN
zh-CN-liaoning-XiaobeiNeural	♀ Mujer	zh-CN
zh-CN-shaanxi-XiaoniNeural	♀ Mujer	zh-CN
zh-HK-HiuGaaiNeural	♀ Mujer	zh-HK
zh-HK-HiuMaanNeural	♀ Mujer	zh-HK
zh-HK-WanLungNeural	♂ Hombre	zh-HK
zh-TW-HsiaoChenNeural	♀ Mujer	zh-TW
zh-TW-HsiaoYuNeural	♀ Mujer	zh-TW
zh-TW-YunJheNeural	♂ Hombre	zh-TW
zu-ZA-ThandoNeural	♀ Mujer	zu-ZA
zu-ZA-ThembaNeural	♂ Hombre	zu-ZA

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
text	string	-	Texto a sintetizar.
voice	string	es-ES-AlvaroNeural	Identificador de la voz.

Opción 1: Descarga Directa (Por defecto)

Request (cURL)

curl -X POST "https://api.videostack.app/audio/tts" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Bienvenidos al tutorial oficial de VideoStack.",
    "voice": "es-ES-ElviraNeural"
  }'

Response (Binario)

HTTP/1.1 200 OK
Content-Type: audio/mpeg
Content-Disposition: attachment; filename="tts_output.mp3"
Content-Length: 150123

<binary_data>

Opción 2: Obtener URL S3 (?return_type=url)

Request (cURL)

curl -X POST "https://api.videostack.app/audio/tts?return_type=url" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Bienvenidos al tutorial oficial de VideoStack.",
    "voice": "es-ES-ElviraNeural"
  }'

Response (JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Audio generado",
  "url": "https://cdn.videostack.app/uploads/..."
}

POST/animate/imageASÍNCRONO (WEBHOOK)

Animar Imagen Estática

Transforma una simple imagen JPG/PNG en un clip de video dinámico usando paneos y zooms automatizados, ideal para B-Roll o slideshows.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
image_url	string	-	URL de la imagen.
effect	string	zoom_in	zoom_in, zoom_out, pan_right, pan_left, pan_up, pan_down.
duration	number	5	Duración en segundos (1-60).
zoom_level	number	1.5	Intensidad del zoom (1.0 a 3.0).

Request (cURL)

curl -X POST "https://api.videostack.app/animate/image" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "image_url": "https://example.com/photo.jpg",
    "effect": "pan_right",
    "duration": 8,
    "zoom_level": 1.2
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/video/dubASÍNCRONO (WEBHOOK)

Doblaje Automático IA

El pipeline definitivo: Transcribe el video, traduce el texto, genera el nuevo audio con TTS ajustando velocidades, aplica Audio Ducking al audio original y une todo en un nuevo video final.

Catálogo de Voces e Idiomas Soportados

La API soporta traducciones a más de 100 idiomas (código ISO-639-1) y síntesis de voz con redes neuronales. Aquí listamos las voces de mayor calidad para los idiomas más populares.

Español (es) 🇪🇸 🇲🇽

es-ES-AlvaroNeural (M)
es-ES-ElviraNeural (F)
es-MX-DaliaNeural (F)
es-MX-JorgeNeural (M)

Inglés (en) 🇺🇸 🇬🇧

en-US-AriaNeural (F)
en-US-GuyNeural (M)
en-GB-SoniaNeural (F)
en-GB-RyanNeural (M)

Francés (fr) 🇫🇷

fr-FR-DeniseNeural (F)
fr-FR-HenriNeural (M)

Alemán (de) 🇩🇪

de-DE-KatjaNeural (F)
de-DE-ConradNeural (M)

Italiano (it) 🇮🇹

it-IT-IsabellaNeural (F)
it-IT-DiegoNeural (M)

Portugués (pt) 🇧🇷 🇵🇹

pt-BR-FranciscaNeural (F)
pt-BR-AntonioNeural (M)
pt-PT-DuarteNeural (M)

Ver catálogo completo de 322 voces soportadas

ID de la Voz (API)	Género	Idioma / Región
af-ZA-AdriNeural	♀ Mujer	af-ZA
af-ZA-WillemNeural	♂ Hombre	af-ZA
am-ET-AmehaNeural	♂ Hombre	am-ET
am-ET-MekdesNeural	♀ Mujer	am-ET
ar-AE-FatimaNeural	♀ Mujer	ar-AE
ar-AE-HamdanNeural	♂ Hombre	ar-AE
ar-BH-AliNeural	♂ Hombre	ar-BH
ar-BH-LailaNeural	♀ Mujer	ar-BH
ar-DZ-AminaNeural	♀ Mujer	ar-DZ
ar-DZ-IsmaelNeural	♂ Hombre	ar-DZ
ar-EG-SalmaNeural	♀ Mujer	ar-EG
ar-EG-ShakirNeural	♂ Hombre	ar-EG
ar-IQ-BasselNeural	♂ Hombre	ar-IQ
ar-IQ-RanaNeural	♀ Mujer	ar-IQ
ar-JO-SanaNeural	♀ Mujer	ar-JO
ar-JO-TaimNeural	♂ Hombre	ar-JO
ar-KW-FahedNeural	♂ Hombre	ar-KW
ar-KW-NouraNeural	♀ Mujer	ar-KW
ar-LB-LaylaNeural	♀ Mujer	ar-LB
ar-LB-RamiNeural	♂ Hombre	ar-LB
ar-LY-ImanNeural	♀ Mujer	ar-LY
ar-LY-OmarNeural	♂ Hombre	ar-LY
ar-MA-JamalNeural	♂ Hombre	ar-MA
ar-MA-MounaNeural	♀ Mujer	ar-MA
ar-OM-AbdullahNeural	♂ Hombre	ar-OM
ar-OM-AyshaNeural	♀ Mujer	ar-OM
ar-QA-AmalNeural	♀ Mujer	ar-QA
ar-QA-MoazNeural	♂ Hombre	ar-QA
ar-SA-HamedNeural	♂ Hombre	ar-SA
ar-SA-ZariyahNeural	♀ Mujer	ar-SA
ar-SY-AmanyNeural	♀ Mujer	ar-SY
ar-SY-LaithNeural	♂ Hombre	ar-SY
ar-TN-HediNeural	♂ Hombre	ar-TN
ar-TN-ReemNeural	♀ Mujer	ar-TN
ar-YE-MaryamNeural	♀ Mujer	ar-YE
ar-YE-SalehNeural	♂ Hombre	ar-YE
az-AZ-BabekNeural	♂ Hombre	az-AZ
az-AZ-BanuNeural	♀ Mujer	az-AZ
bg-BG-BorislavNeural	♂ Hombre	bg-BG
bg-BG-KalinaNeural	♀ Mujer	bg-BG
bn-BD-NabanitaNeural	♀ Mujer	bn-BD
bn-BD-PradeepNeural	♂ Hombre	bn-BD
bn-IN-BashkarNeural	♂ Hombre	bn-IN
bn-IN-TanishaaNeural	♀ Mujer	bn-IN
bs-BA-GoranNeural	♂ Hombre	bs-BA
bs-BA-VesnaNeural	♀ Mujer	bs-BA
ca-ES-EnricNeural	♂ Hombre	ca-ES
ca-ES-JoanaNeural	♀ Mujer	ca-ES
cs-CZ-AntoninNeural	♂ Hombre	cs-CZ
cs-CZ-VlastaNeural	♀ Mujer	cs-CZ
cy-GB-AledNeural	♂ Hombre	cy-GB
cy-GB-NiaNeural	♀ Mujer	cy-GB
da-DK-ChristelNeural	♀ Mujer	da-DK
da-DK-JeppeNeural	♂ Hombre	da-DK
de-AT-IngridNeural	♀ Mujer	de-AT
de-AT-JonasNeural	♂ Hombre	de-AT
de-CH-JanNeural	♂ Hombre	de-CH
de-CH-LeniNeural	♀ Mujer	de-CH
de-DE-AmalaNeural	♀ Mujer	de-DE
de-DE-ConradNeural	♂ Hombre	de-DE
de-DE-FlorianMultilingualNeural	♂ Hombre	de-DE
de-DE-KatjaNeural	♀ Mujer	de-DE
de-DE-KillianNeural	♂ Hombre	de-DE
de-DE-SeraphinaMultilingualNeural	♀ Mujer	de-DE
el-GR-AthinaNeural	♀ Mujer	el-GR
el-GR-NestorasNeural	♂ Hombre	el-GR
en-AU-NatashaNeural	♀ Mujer	en-AU
en-AU-WilliamMultilingualNeural	♂ Hombre	en-AU
en-CA-ClaraNeural	♀ Mujer	en-CA
en-CA-LiamNeural	♂ Hombre	en-CA
en-GB-LibbyNeural	♀ Mujer	en-GB
en-GB-MaisieNeural	♀ Mujer	en-GB
en-GB-RyanNeural	♂ Hombre	en-GB
en-GB-SoniaNeural	♀ Mujer	en-GB
en-GB-ThomasNeural	♂ Hombre	en-GB
en-HK-SamNeural	♂ Hombre	en-HK
en-HK-YanNeural	♀ Mujer	en-HK
en-IE-ConnorNeural	♂ Hombre	en-IE
en-IE-EmilyNeural	♀ Mujer	en-IE
en-IN-NeerjaExpressiveNeural	♀ Mujer	en-IN
en-IN-NeerjaNeural	♀ Mujer	en-IN
en-IN-PrabhatNeural	♂ Hombre	en-IN
en-KE-AsiliaNeural	♀ Mujer	en-KE
en-KE-ChilembaNeural	♂ Hombre	en-KE
en-NG-AbeoNeural	♂ Hombre	en-NG
en-NG-EzinneNeural	♀ Mujer	en-NG
en-NZ-MitchellNeural	♂ Hombre	en-NZ
en-NZ-MollyNeural	♀ Mujer	en-NZ
en-PH-JamesNeural	♂ Hombre	en-PH
en-PH-RosaNeural	♀ Mujer	en-PH
en-SG-LunaNeural	♀ Mujer	en-SG
en-SG-WayneNeural	♂ Hombre	en-SG
en-TZ-ElimuNeural	♂ Hombre	en-TZ
en-TZ-ImaniNeural	♀ Mujer	en-TZ
en-US-AnaNeural	♀ Mujer	en-US
en-US-AndrewMultilingualNeural	♂ Hombre	en-US
en-US-AndrewNeural	♂ Hombre	en-US
en-US-AriaNeural	♀ Mujer	en-US
en-US-AvaMultilingualNeural	♀ Mujer	en-US
en-US-AvaNeural	♀ Mujer	en-US
en-US-BrianMultilingualNeural	♂ Hombre	en-US
en-US-BrianNeural	♂ Hombre	en-US
en-US-ChristopherNeural	♂ Hombre	en-US
en-US-EmmaMultilingualNeural	♀ Mujer	en-US
en-US-EmmaNeural	♀ Mujer	en-US
en-US-EricNeural	♂ Hombre	en-US
en-US-GuyNeural	♂ Hombre	en-US
en-US-JennyNeural	♀ Mujer	en-US
en-US-MichelleNeural	♀ Mujer	en-US
en-US-RogerNeural	♂ Hombre	en-US
en-US-SteffanNeural	♂ Hombre	en-US
en-ZA-LeahNeural	♀ Mujer	en-ZA
en-ZA-LukeNeural	♂ Hombre	en-ZA
es-AR-ElenaNeural	♀ Mujer	es-AR
es-AR-TomasNeural	♂ Hombre	es-AR
es-BO-MarceloNeural	♂ Hombre	es-BO
es-BO-SofiaNeural	♀ Mujer	es-BO
es-CL-CatalinaNeural	♀ Mujer	es-CL
es-CL-LorenzoNeural	♂ Hombre	es-CL
es-CO-GonzaloNeural	♂ Hombre	es-CO
es-CO-SalomeNeural	♀ Mujer	es-CO
es-CR-JuanNeural	♂ Hombre	es-CR
es-CR-MariaNeural	♀ Mujer	es-CR
es-CU-BelkysNeural	♀ Mujer	es-CU
es-CU-ManuelNeural	♂ Hombre	es-CU
es-DO-EmilioNeural	♂ Hombre	es-DO
es-DO-RamonaNeural	♀ Mujer	es-DO
es-EC-AndreaNeural	♀ Mujer	es-EC
es-EC-LuisNeural	♂ Hombre	es-EC
es-ES-AlvaroNeural	♂ Hombre	es-ES
es-ES-ElviraNeural	♀ Mujer	es-ES
es-ES-XimenaNeural	♀ Mujer	es-ES
es-GQ-JavierNeural	♂ Hombre	es-GQ
es-GQ-TeresaNeural	♀ Mujer	es-GQ
es-GT-AndresNeural	♂ Hombre	es-GT
es-GT-MartaNeural	♀ Mujer	es-GT
es-HN-CarlosNeural	♂ Hombre	es-HN
es-HN-KarlaNeural	♀ Mujer	es-HN
es-MX-DaliaNeural	♀ Mujer	es-MX
es-MX-JorgeNeural	♂ Hombre	es-MX
es-NI-FedericoNeural	♂ Hombre	es-NI
es-NI-YolandaNeural	♀ Mujer	es-NI
es-PA-MargaritaNeural	♀ Mujer	es-PA
es-PA-RobertoNeural	♂ Hombre	es-PA
es-PE-AlexNeural	♂ Hombre	es-PE
es-PE-CamilaNeural	♀ Mujer	es-PE
es-PR-KarinaNeural	♀ Mujer	es-PR
es-PR-VictorNeural	♂ Hombre	es-PR
es-PY-MarioNeural	♂ Hombre	es-PY
es-PY-TaniaNeural	♀ Mujer	es-PY
es-SV-LorenaNeural	♀ Mujer	es-SV
es-SV-RodrigoNeural	♂ Hombre	es-SV
es-US-AlonsoNeural	♂ Hombre	es-US
es-US-PalomaNeural	♀ Mujer	es-US
es-UY-MateoNeural	♂ Hombre	es-UY
es-UY-ValentinaNeural	♀ Mujer	es-UY
es-VE-PaolaNeural	♀ Mujer	es-VE
es-VE-SebastianNeural	♂ Hombre	es-VE
et-EE-AnuNeural	♀ Mujer	et-EE
et-EE-KertNeural	♂ Hombre	et-EE
fa-IR-DilaraNeural	♀ Mujer	fa-IR
fa-IR-FaridNeural	♂ Hombre	fa-IR
fi-FI-HarriNeural	♂ Hombre	fi-FI
fi-FI-NooraNeural	♀ Mujer	fi-FI
fil-PH-AngeloNeural	♂ Hombre	fil-PH
fil-PH-BlessicaNeural	♀ Mujer	fil-PH
fr-BE-CharlineNeural	♀ Mujer	fr-BE
fr-BE-GerardNeural	♂ Hombre	fr-BE
fr-CA-AntoineNeural	♂ Hombre	fr-CA
fr-CA-JeanNeural	♂ Hombre	fr-CA
fr-CA-SylvieNeural	♀ Mujer	fr-CA
fr-CA-ThierryNeural	♂ Hombre	fr-CA
fr-CH-ArianeNeural	♀ Mujer	fr-CH
fr-CH-FabriceNeural	♂ Hombre	fr-CH
fr-FR-DeniseNeural	♀ Mujer	fr-FR
fr-FR-EloiseNeural	♀ Mujer	fr-FR
fr-FR-HenriNeural	♂ Hombre	fr-FR
fr-FR-RemyMultilingualNeural	♂ Hombre	fr-FR
fr-FR-VivienneMultilingualNeural	♀ Mujer	fr-FR
ga-IE-ColmNeural	♂ Hombre	ga-IE
ga-IE-OrlaNeural	♀ Mujer	ga-IE
gl-ES-RoiNeural	♂ Hombre	gl-ES
gl-ES-SabelaNeural	♀ Mujer	gl-ES
gu-IN-DhwaniNeural	♀ Mujer	gu-IN
gu-IN-NiranjanNeural	♂ Hombre	gu-IN
he-IL-AvriNeural	♂ Hombre	he-IL
he-IL-HilaNeural	♀ Mujer	he-IL
hi-IN-MadhurNeural	♂ Hombre	hi-IN
hi-IN-SwaraNeural	♀ Mujer	hi-IN
hr-HR-GabrijelaNeural	♀ Mujer	hr-HR
hr-HR-SreckoNeural	♂ Hombre	hr-HR
hu-HU-NoemiNeural	♀ Mujer	hu-HU
hu-HU-TamasNeural	♂ Hombre	hu-HU
id-ID-ArdiNeural	♂ Hombre	id-ID
id-ID-GadisNeural	♀ Mujer	id-ID
is-IS-GudrunNeural	♀ Mujer	is-IS
is-IS-GunnarNeural	♂ Hombre	is-IS
it-IT-DiegoNeural	♂ Hombre	it-IT
it-IT-ElsaNeural	♀ Mujer	it-IT
it-IT-GiuseppeMultilingualNeural	♂ Hombre	it-IT
it-IT-IsabellaNeural	♀ Mujer	it-IT
iu-Cans-CA-SiqiniqNeural	♀ Mujer	iu-Cans
iu-Cans-CA-TaqqiqNeural	♂ Hombre	iu-Cans
iu-Latn-CA-SiqiniqNeural	♀ Mujer	iu-Latn
iu-Latn-CA-TaqqiqNeural	♂ Hombre	iu-Latn
ja-JP-KeitaNeural	♂ Hombre	ja-JP
ja-JP-NanamiNeural	♀ Mujer	ja-JP
jv-ID-DimasNeural	♂ Hombre	jv-ID
jv-ID-SitiNeural	♀ Mujer	jv-ID
ka-GE-EkaNeural	♀ Mujer	ka-GE
ka-GE-GiorgiNeural	♂ Hombre	ka-GE
kk-KZ-AigulNeural	♀ Mujer	kk-KZ
kk-KZ-DauletNeural	♂ Hombre	kk-KZ
km-KH-PisethNeural	♂ Hombre	km-KH
km-KH-SreymomNeural	♀ Mujer	km-KH
kn-IN-GaganNeural	♂ Hombre	kn-IN
kn-IN-SapnaNeural	♀ Mujer	kn-IN
ko-KR-HyunsuMultilingualNeural	♂ Hombre	ko-KR
ko-KR-InJoonNeural	♂ Hombre	ko-KR
ko-KR-SunHiNeural	♀ Mujer	ko-KR
lo-LA-ChanthavongNeural	♂ Hombre	lo-LA
lo-LA-KeomanyNeural	♀ Mujer	lo-LA
lt-LT-LeonasNeural	♂ Hombre	lt-LT
lt-LT-OnaNeural	♀ Mujer	lt-LT
lv-LV-EveritaNeural	♀ Mujer	lv-LV
lv-LV-NilsNeural	♂ Hombre	lv-LV
mk-MK-AleksandarNeural	♂ Hombre	mk-MK
mk-MK-MarijaNeural	♀ Mujer	mk-MK
ml-IN-MidhunNeural	♂ Hombre	ml-IN
ml-IN-SobhanaNeural	♀ Mujer	ml-IN
mn-MN-BataaNeural	♂ Hombre	mn-MN
mn-MN-YesuiNeural	♀ Mujer	mn-MN
mr-IN-AarohiNeural	♀ Mujer	mr-IN
mr-IN-ManoharNeural	♂ Hombre	mr-IN
ms-MY-OsmanNeural	♂ Hombre	ms-MY
ms-MY-YasminNeural	♀ Mujer	ms-MY
mt-MT-GraceNeural	♀ Mujer	mt-MT
mt-MT-JosephNeural	♂ Hombre	mt-MT
my-MM-NilarNeural	♀ Mujer	my-MM
my-MM-ThihaNeural	♂ Hombre	my-MM
nb-NO-FinnNeural	♂ Hombre	nb-NO
nb-NO-PernilleNeural	♀ Mujer	nb-NO
ne-NP-HemkalaNeural	♀ Mujer	ne-NP
ne-NP-SagarNeural	♂ Hombre	ne-NP
nl-BE-ArnaudNeural	♂ Hombre	nl-BE
nl-BE-DenaNeural	♀ Mujer	nl-BE
nl-NL-ColetteNeural	♀ Mujer	nl-NL
nl-NL-FennaNeural	♀ Mujer	nl-NL
nl-NL-MaartenNeural	♂ Hombre	nl-NL
pl-PL-MarekNeural	♂ Hombre	pl-PL
pl-PL-ZofiaNeural	♀ Mujer	pl-PL
ps-AF-GulNawazNeural	♂ Hombre	ps-AF
ps-AF-LatifaNeural	♀ Mujer	ps-AF
pt-BR-AntonioNeural	♂ Hombre	pt-BR
pt-BR-FranciscaNeural	♀ Mujer	pt-BR
pt-BR-ThalitaMultilingualNeural	♀ Mujer	pt-BR
pt-PT-DuarteNeural	♂ Hombre	pt-PT
pt-PT-RaquelNeural	♀ Mujer	pt-PT
ro-RO-AlinaNeural	♀ Mujer	ro-RO
ro-RO-EmilNeural	♂ Hombre	ro-RO
ru-RU-DmitryNeural	♂ Hombre	ru-RU
ru-RU-SvetlanaNeural	♀ Mujer	ru-RU
si-LK-SameeraNeural	♂ Hombre	si-LK
si-LK-ThiliniNeural	♀ Mujer	si-LK
sk-SK-LukasNeural	♂ Hombre	sk-SK
sk-SK-ViktoriaNeural	♀ Mujer	sk-SK
sl-SI-PetraNeural	♀ Mujer	sl-SI
sl-SI-RokNeural	♂ Hombre	sl-SI
so-SO-MuuseNeural	♂ Hombre	so-SO
so-SO-UbaxNeural	♀ Mujer	so-SO
sq-AL-AnilaNeural	♀ Mujer	sq-AL
sq-AL-IlirNeural	♂ Hombre	sq-AL
sr-RS-NicholasNeural	♂ Hombre	sr-RS
sr-RS-SophieNeural	♀ Mujer	sr-RS
su-ID-JajangNeural	♂ Hombre	su-ID
su-ID-TutiNeural	♀ Mujer	su-ID
sv-SE-MattiasNeural	♂ Hombre	sv-SE
sv-SE-SofieNeural	♀ Mujer	sv-SE
sw-KE-RafikiNeural	♂ Hombre	sw-KE
sw-KE-ZuriNeural	♀ Mujer	sw-KE
sw-TZ-DaudiNeural	♂ Hombre	sw-TZ
sw-TZ-RehemaNeural	♀ Mujer	sw-TZ
ta-IN-PallaviNeural	♀ Mujer	ta-IN
ta-IN-ValluvarNeural	♂ Hombre	ta-IN
ta-LK-KumarNeural	♂ Hombre	ta-LK
ta-LK-SaranyaNeural	♀ Mujer	ta-LK
ta-MY-KaniNeural	♀ Mujer	ta-MY
ta-MY-SuryaNeural	♂ Hombre	ta-MY
ta-SG-AnbuNeural	♂ Hombre	ta-SG
ta-SG-VenbaNeural	♀ Mujer	ta-SG
te-IN-MohanNeural	♂ Hombre	te-IN
te-IN-ShrutiNeural	♀ Mujer	te-IN
th-TH-NiwatNeural	♂ Hombre	th-TH
th-TH-PremwadeeNeural	♀ Mujer	th-TH
tr-TR-AhmetNeural	♂ Hombre	tr-TR
tr-TR-EmelNeural	♀ Mujer	tr-TR
uk-UA-OstapNeural	♂ Hombre	uk-UA
uk-UA-PolinaNeural	♀ Mujer	uk-UA
ur-IN-GulNeural	♀ Mujer	ur-IN
ur-IN-SalmanNeural	♂ Hombre	ur-IN
ur-PK-AsadNeural	♂ Hombre	ur-PK
ur-PK-UzmaNeural	♀ Mujer	ur-PK
uz-UZ-MadinaNeural	♀ Mujer	uz-UZ
uz-UZ-SardorNeural	♂ Hombre	uz-UZ
vi-VN-HoaiMyNeural	♀ Mujer	vi-VN
vi-VN-NamMinhNeural	♂ Hombre	vi-VN
zh-CN-XiaoxiaoNeural	♀ Mujer	zh-CN
zh-CN-XiaoyiNeural	♀ Mujer	zh-CN
zh-CN-YunjianNeural	♂ Hombre	zh-CN
zh-CN-YunxiNeural	♂ Hombre	zh-CN
zh-CN-YunxiaNeural	♂ Hombre	zh-CN
zh-CN-YunyangNeural	♂ Hombre	zh-CN
zh-CN-liaoning-XiaobeiNeural	♀ Mujer	zh-CN
zh-CN-shaanxi-XiaoniNeural	♀ Mujer	zh-CN
zh-HK-HiuGaaiNeural	♀ Mujer	zh-HK
zh-HK-HiuMaanNeural	♀ Mujer	zh-HK
zh-HK-WanLungNeural	♂ Hombre	zh-HK
zh-TW-HsiaoChenNeural	♀ Mujer	zh-TW
zh-TW-HsiaoYuNeural	♀ Mujer	zh-TW
zh-TW-YunJheNeural	♂ Hombre	zh-TW
zu-ZA-ThandoNeural	♀ Mujer	zu-ZA
zu-ZA-ThembaNeural	♂ Hombre	zu-ZA

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
webhook_url	string	-	URL opcional para recibir el webhook al finalizar (Ver guía de Arquitectura Asíncrona).
video_url	string	-	URL del video en idioma original.
target_lang	string	es	Idioma destino (ej: es, fr, en).
voice	string	es-ES-AlvaroNeural	Voz neuronal a utilizar en el nuevo idioma.

Request (cURL)

curl -X POST "https://api.videostack.app/video/dub" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-dominio.com/webhook",
    "video_url": "https://example.com/english_video.mp4",
    "target_lang": "es",
    "voice": "es-ES-AlvaroNeural"
  }'

Response (HTTP/JSON)

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "job_id": "7a9b1c...",
  "status": "processing"
}

POST/download/mediaSÍNCRONO

Descarga Universal de RRSS

Extrae el MP4 o MP3 subyacente de URLs de plataformas de redes sociales (YouTube, TikTok, Twitter, Instagram, etc) utilizando yt-dlp.

Parámetros de la Petición

Nombre	Tipo	Default	Descripción
url	string	-	Enlace al post de la red social.
media_type	string	video	video o audio.

Opción 1: Descarga Directa (Por defecto)

Request (cURL)

curl -X POST "https://api.videostack.app/download/media" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@user/video/123456",
    "media_type": "video"
  }'

Response (Binario)

HTTP/1.1 200 OK
Content-Type: video/mp4
Content-Disposition: attachment; filename="tiktok_video.mp4"
Content-Length: 8450123

<binary_data>

Opción 2: Obtener URL S3 (?return_type=url)

Request (cURL)

curl -X POST "https://api.videostack.app/download/media?return_type=url" \
  -H "X-API-Key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@user/video/123456",
    "media_type": "video"
  }'

Response (JSON)

HTTP/1.1 200 OK
Content-Type: application/json

{
  "message": "Descarga completada",
  "url": "https://cdn.videostack.app/uploads/..."
}