Communitygithub.com

Mejora de Video con IA

Mejora la calidad de tus videos usando IA. Aumenta la resolución, reduce el ruido y afínalos para obtener calidad HD/4K. Soporta archivos locales, URLs remotas (YouTube, Bilibili) y seguimiento del progreso en tiempo real.

¿Qué es Mejora de Video con IA?

Este skill de agente de IA permite mejorar la calidad de videos mediante la API de verging.ai. Sus capacidades incluyen aumentar la resolución (hasta 4K), reducir ruido, afinar detalles y restaurar videos de baja calidad o antiguos. Es compatible con archivos de video locales y URLs remotas de plataformas como YouTube y Bilibili, descargando automáticamente estos últimos usando yt-dlp. El proceso admite opciones como modo HD (mayor calidad), recorte temporal (inicio/fin), seguimiento en tiempo real del progreso y descarga automática del resultado. Está diseñado para asistentes CLI (como Claude Code, Cursor o Codex) y requiere una clave API de verging.ai para autenticarse. El skill se encarga de todo el flujo: verificar dependencias, descargar y recortar el video si es necesario, subirlo a la nube, crear el trabajo de mejora, consultar su estado y devolver la URL del video mejorado. Es ideal para desarrolladores y creadores de contenido que necesitan integrar mejora de video por IA directamente desde la línea de comandos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/verging-ai/video-enhancement

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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ónCortaDescripciónPor Defecto
--video-vRuta del archivo de video o URLRequerido
--hd-hModo HD (mejora de mayor calidad)false
--start-ssTiempo de inicio en segundos0
--end-eTiempo de fin en segundosDuración del video
--api-key-kTu clave APIVariable de entorno VERGING_API_KEY
--output-oRuta de guardado del resultadoDirectorio actual
--download-dDescargar automáticamente el resultado al localfalse

Variables de Entorno

VariableDescripción
VERGING_API_KEYTu clave API
VERGING_API_URLURL base de la API (por defecto: https://verging.ai/api/v1)

Endpoints de la API

EndpointMétodoFormatoPropósito
/api/v1/auth/meGET-Obtener información del usuario (incluyendo créditos)
/api/v1/upload-videoPOSTForm DataObtener URL de subida prefirmada de R2
/api/v1/video_enhance/create-jobPOSTForm DataCrear trabajo de mejora de video
/api/v1/jobs/list-jobsGET-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_KEY con tu clave API real o establécela como variable de entorno
  • El encabezado Authorization usa el formato: ApiKey <clave> (no Bearer <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-dlp directamente si ya está disponible en el sistema
    • Si no hay ninguna herramienta de descarga disponible, pide al usuario que descargue el video localmente primero
  • 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-dlp está 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
  • 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-video con 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_url de la respuesta para el siguiente paso

7. Crear Trabajo

  • Llama a /api/v1/video_enhance/create-job con Form Data:
    • target_video_url: La URL pública del video del paso 6
    • file_name: Nombre original del archivo
    • user_video_duration: Duración del video en segundos
    • job_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=xxx para 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

ModoCréditos/segundo
Normal1 crédito/segundo
HD3 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ú:

  1. Analizar argumentos - video local, modo normal
  2. Obtener duración del video
  3. Llamar a la API para obtener información del usuario
  4. Verificar créditos suficientes (duración × 1 crédito/segundo)
  5. Subir video a R2
  6. Crear trabajo de mejora de video
  7. Consultar hasta completar
  8. Devolver URL del resultado

Usuario: /video-enhancement -v "https://youtube.com/watch?v=xxx" --hd --start 5 --end 15

Tú:

  1. Analizar argumentos - video remoto, modo HD, recortar 5-15s
  2. Descargar video usando yt-dlp
  3. Recortar video a 10 segundos
  4. Obtener duración del video recortado
  5. Verificar créditos suficientes (10 seg × 3 créditos/segundo = 30 créditos)
  6. Subir video recortado a R2
  7. Crear trabajo de mejora de video con is_hd=true
  8. Consultar hasta completar
  9. 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:

  1. Visita https://verging.ai
  2. Inicia sesión → Haz clic en el avatar del usuario (arriba a la derecha) → Selecciona "Claves API"
  3. 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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados