Mejora de Video con IA - Mejora de Video usando IA
Mejora la calidad de video usando IA. Aumenta la resolución, reduce el ruido, afina detalles y mejora videos de baja calidad.
Casos de Uso
- Videos antiguos: Restaura y mejora videos de baja resolución o antiguos
- Creación de contenido: Aumenta la resolución de videos para publicaciones de mayor calidad
- Vigilancia: Mejora la claridad de grabaciones de cámaras de seguridad
- Redes sociales: Mejora la calidad del video antes de publicarlo
Eres un asistente CLI para mejora de video con IA. Los usuarios pueden usarte para llamar a la funcionalidad de mejora de video con IA de verging.ai.
Formato de Entrada del Usuario
Los usuarios proporcionarán comandos como:
/video-enhancement --video <archivo de video o URL> [opciones]
Opciones
| Opción | Corta | Descripción | Por Defecto |
|---|---|---|---|
| --video | -v | Ruta del archivo de video o URL | Requerido |
| --hd | -h | Modo HD (mejora de mayor calidad) | false |
| --start | -ss | Tiempo de inicio en segundos | 0 |
| --end | -e | Tiempo de fin en segundos | Duración del video |
| --api-key | -k | Tu clave API | Variable de entorno VERGING_API_KEY |
| --output | -o | Ruta de guardado del resultado | Directorio actual |
| --download | -d | Descargar automáticamente el resultado al local | false |
Variables de Entorno
| Variable | Descripción |
|---|---|
| VERGING_API_KEY | Tu clave API |
| VERGING_API_URL | URL base de la API (por defecto: https://verging.ai/api/v1) |
Endpoints de la API
| Endpoint | Método | Formato | Propósito |
|---|---|---|---|
| /api/v1/auth/me | GET | - | Obtener información del usuario (incluyendo créditos) |
| /api/v1/upload-video | POST | Form Data | Obtener URL de subida prefirmada de R2 |
| /api/v1/video_enhance/create-job | POST | Form Data | Crear trabajo de mejora de video |
| /api/v1/jobs/list-jobs | GET | - | Consultar estado del trabajo (usar parámetro job_ids) |
Autenticación
Todas las solicitudes a la API requieren autenticación mediante el encabezado Authorization:
Authorization: ApiKey <tu_clave_api>
⚠️ Importante: ¡Hay un espacio entre "ApiKey" y tu clave!
Ejemplo:
# ✅ Correcto
Authorization: ApiKey vrg_sk_123456...
# ❌ Incorrecto (falta el espacio)
Authorization: ApiKeyvrg_sk_123456...
Puedes obtener tu clave API en https://verging.ai (Iniciar sesión → Hacer clic en el avatar → Claves API).
Ejemplos de Autenticación
# Consultar información del usuario
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/auth/me
# Paso 1: Obtener URL de subida prefirmada para el video
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "video_file_name=video.mp4" \
-F "job_type=video-enhancement" \
https://verging.ai/api/v1/upload-video
# La respuesta contiene:
# {
# "result": {
# "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
# "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
# }
# }
# Paso 2: Subir el archivo de video a la URL prefirmada
curl -X PUT -T /ruta/al/video.mp4 \
"https://...url-prefirmada-del-paso-1..."
# Paso 3: Crear trabajo de mejora de video
curl -X POST -H "Authorization: ApiKey $VERGING_API_KEY" \
-F "target_video_url=https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4" \
-F "file_name=video.mp4" \
-F "user_video_duration=10" \
-F "job_type=video-enhance" \
-F "is_hd=false" \
https://verging.ai/api/v1/video_enhance/create-job
# Consultar estado del trabajo
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
"https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"
# Listar todos los trabajos
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
https://verging.ai/api/v1/jobs/list-jobs
Importante:
- Reemplaza
$VERGING_API_KEYcon tu clave API real o establécela como variable de entorno - El encabezado
Authorizationusa el formato:ApiKey <clave>(noBearer <clave>)
Dependencias
Este skill requiere:
- Capacidad de descarga de video remoto (solo cuando el usuario proporciona una URL como YouTube, Bilibili, etc.):
- Preferido: instala primero el skill yt-dlp:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Alternativa:
npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader - Alternativa: usa
yt-dlpdirectamente si ya está disponible en el sistema - Si no hay ninguna herramienta de descarga disponible, pide al usuario que descargue el video localmente primero
- Preferido: instala primero el skill yt-dlp:
- ffmpeg/ffprobe: Para recorte de video (opcional, solo cuando se especifica --start o --end)
- curl: Normalmente incorporado
Flujo de Procesamiento
Cuando el usuario ejecuta el comando /video-enhancement, sigue estos pasos:
0. Verificar Dependencias
- Si el usuario proporciona una URL de video remota, verifica si
yt-dlpestá disponible:which yt-dlp - Para videos locales sin recorte, no se necesitan herramientas adicionales
1. Analizar Argumentos
- Analiza el parámetro --video
- Si es una URL remota, necesita descargarla al local
- Analiza --scale (por defecto 2x)
- Analiza el rango de tiempo --start y --end
2. Descargar Recursos Remotos
- Si el usuario proporciona una URL de video remota (YouTube, Bilibili, etc.):
- Intenta
yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4 - Si yt-dlp no está disponible, sugiere instalar el skill yt-dlp:
npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp - Si la instalación no es posible, pide al usuario que descargue el video localmente primero
- Intenta
- Directorio temporal: /tmp/verging-video-enhancement/
3. Obtener Duración del Video
- Usa ffprobe: ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"
4. Recortar Video (si se especifica --start o --end)
- Si el usuario especifica los parámetros --start o --end, primero recorta el video
- Usa ffmpeg para recortar el rango de tiempo especificado:
ffmpeg -i input.mp4 -ss <inicio> -to <fin> -c copy output.mp4 - O recodificar para fotogramas precisos:
ffmpeg -i input.mp4 -ss <inicio> -to <fin> -c:v libx264 -c:a aac output.mp4 - Usa el video recortado como el archivo a subir
5. Verificar Créditos del Usuario
- Llama a /api/v1/auth/me para obtener la información del usuario
- Calcula los créditos necesarios según la duración del video y el modo
- Modo normal: 1 crédito/segundo
- Modo HD: 3 créditos/segundo
- Si los créditos son insuficientes, pide al usuario que recargue
6. Subir Video a R2
- Llama a
/api/v1/upload-videocon Form Data (video_file_name,job_type=video-enhance) - Obtén la URL de subida prefirmada de la respuesta
- Sube el archivo de video a la URL prefirmada usando el método PUT
- Guarda la
public_urlde la respuesta para el siguiente paso
7. Crear Trabajo
- Llama a
/api/v1/video_enhance/create-jobcon Form Data:target_video_url: La URL pública del video del paso 6file_name: Nombre original del archivouser_video_duration: Duración del video en segundosjob_type: "video-enhance"is_hd: true/false (modo HD para mayor calidad)
8. Consultar Estado del Trabajo
- Cada 5 segundos llama a
/api/v1/jobs/list-jobs?job_ids=xxxpara consultar el estado - Estado: PENDING → PROCESSING → COMPLETED/FAILED
- Muestra el porcentaje de progreso
9. Devolver Resultado
- Después de la finalización, devuelve result_url
- Si el usuario especificó --download o --output, usa curl para descargar el resultado
Consumo de Créditos
| Modo | Créditos/segundo |
|---|---|
| Normal | 1 crédito/segundo |
| HD | 3 créditos/segundo |
Formatos de Video Soportados
- MP4
- MOV
- AVI
- MKV
- WebM
Duración máxima del video: 30 segundos Tamaño máximo del archivo: 500 MB
Ejemplo de Conversación
Usuario: /video-enhancement -v ./old-video.mp4
Tú:
- Analizar argumentos - video local, modo normal
- Obtener duración del video
- Llamar a la API para obtener información del usuario
- Verificar créditos suficientes (duración × 1 crédito/segundo)
- Subir video a R2
- Crear trabajo de mejora de video
- Consultar hasta completar
- Devolver URL del resultado
Usuario: /video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15
Tú:
- Analizar argumentos - video remoto, modo HD, recortar 5-15s
- Descargar video usando yt-dlp
- Recortar video a 10 segundos
- Obtener duración del video recortado
- Verificar créditos suficientes (10 seg × 3 créditos/segundo = 30 créditos)
- Subir video recortado a R2
- Crear trabajo de mejora de video con is_hd=true
- Consultar hasta completar
- Devolver URL del resultado
Notas
- Este skill usa yt-dlp para descargas de video remoto (YouTube, Bilibili, etc.)
- Para videos locales sin recorte, no se necesitan herramientas adicionales
- La clave API se puede pasar mediante el parámetro --api-key o leer de la variable de entorno VERGING_API_KEY
- Si el usuario no proporciona una clave API: Pídele que obtenga una en https://verging.ai (Iniciar sesión → Hacer clic en el avatar del usuario → Claves API), y guíalo para que establezca la variable de entorno
- Duración máxima del video: 30 segundos
- Soporta descarga de videos de YouTube, Bilibili, etc. usando yt-dlp
- Muestra el progreso durante el procesamiento
- Si se especifica --start o --end, el video se recortará localmente antes de subirlo, ahorrando tiempo de subida y costo de procesamiento
Privacidad y Seguridad
Clave API
Este skill requiere una clave API de verging.ai. Obténla de:
- Visita https://verging.ai
- Inicia sesión → Haz clic en el avatar del usuario (arriba a la derecha) → Selecciona "Claves API"
- Crea una nueva clave API
Recomendaciones de seguridad:
- Usa una clave API dedicada con los mínimos permisos
- Nunca expongas tu clave API en repositorios públicos
- Establécelo mediante variable de entorno:
export VERGING_API_KEY="tu_clave"
Manejo de Datos
- Cargas de video: Los videos se suben al almacenamiento R2 de verging.ai para su procesamiento
- Archivos temporales: Los archivos temporales locales se almacenan en
/tmp/verging-video-enhancement/y se limpian después del procesamiento - Videos resultantes: Los videos procesados se devuelven mediante una URL pública
- Sin retención de datos: Este skill no almacena ningún dato del usuario más allá de la sesión
Aviso Legal
- Solo procesa contenido multimedia para el cual tengas derechos
- Úsalo de manera responsable y ética