video-enhancement - AI Video Enhancement

Use Cases

• Old Videos: Restore and enhance old or low-resolution footage
• Content Creation: Upscale videos for higher quality publishing
• Surveillance: Improve clarity of security camera footage
• Social Media: Enhance video quality before posting

User Input Format

/video-enhancement --video <video file or URL> [options]

Options

Environment Variables

API Endpoints

Authentication

Authorization

Authorization: ApiKey <your_api_key>

# ✅ Correct
Authorization: ApiKey vrg_sk_123456...

# ❌ Wrong (missing space)
Authorization: ApiKeyvrg_sk_123456...

Authentication Examples

# Check user info
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/auth/me

# Step 1: Get presigned upload URL for 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

# The response contains:
# {
#   "result": {
#     "url": "https://...r2.cloudflarestorage.com/...mp4?X-Amz-...",
#     "public_url": "https://img.panpan8.com/video-enhancement/2026-03-11/xxx.mp4"
#   }
# }

# Step 2: Upload video file to the presigned URL
curl -X PUT -T /path/to/video.mp4 \
  "https://...presigned-url-from-step-1..."

# Step 3: Create video enhancement job
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

# Query job status
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  "https://verging.ai/api/v1/jobs/list-jobs?job_ids=123"

# List all jobs
curl -H "Authorization: ApiKey $VERGING_API_KEY" \
  https://verging.ai/api/v1/jobs/list-jobs

• Replace

  $VERGING_API_KEY

  with your actual API key or set it as an environment variable
• The

  Authorization

  header uses format:

  ApiKey <key>

  (not

  Bearer <key>

  )

Dependencies

• Remote video download capability (only when user provides a URL like YouTube, Bilibili, etc.):
  • Preferred: install yt-dlp skill first:

    npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp

  • Alternative:

    npx skills add mapleshaw/yt-dlp-downloader-skill --skill yt-dlp-downloader

  • Alternative: use

    yt-dlp

    directly if already available on the system
  • If no download tool is available, prompt the user to download the video locally first
• ffmpeg/ffprobe: For video trimming (optional, only when --start or --end specified)
• curl: Usually built-in

Processing Flow

0. Check Dependencies

• If user provides a remote video URL, check if

  yt-dlp

  is available:

  which yt-dlp

• For local videos without trimming, no additional tools needed

1. Parse Arguments

• Parse --video parameter
• If remote URL, need to download to local
• Parse --scale (default 2x)
• Parse time range --start and --end

2. Download Remote Resources

• If user provides a remote video URL (YouTube, Bilibili, etc.):
  • Try

    yt-dlp "URL" -o /tmp/verging-video-enhancement/video.mp4

  • If yt-dlp is not available, suggest installing the yt-dlp skill:

    npx skills add lwmxiaobei/yt-dlp-skill --skill yt-dlp

  • If installation is not possible, ask the user to download the video locally first
• Temp directory: /tmp/verging-video-enhancement/

3. Get Video Duration

• Use ffprobe: ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "video.mp4"

4. Trim Video (if --start or --end specified)

• If user specifies --start or --end parameters, first trim the video
• Use ffmpeg to trim specified time range:

  ffmpeg -i input.mp4 -ss <start> -to <end> -c copy output.mp4

• Or re-encode for accurate frames:

  ffmpeg -i input.mp4 -ss <start> -to <end> -c:v libx264 -c:a aac output.mp4

• Use trimmed video as the file to upload

5. Check User Credits

• Call /api/v1/auth/me to get user info
• Calculate required credits based on video duration and mode
• Normal mode: 1 credit/second
• HD mode: 3 credits/second
• If insufficient credits, prompt user to recharge

6. Upload Video to R2

• Call

  /api/v1/upload-video

  with Form Data (

  video_file_name

  ,

  job_type=video-enhance

  )
• Get presigned upload URL from response
• Upload video file to presigned URL using PUT method
• Save the

  public_url

  from response for next step

7. Create Job

• Call

  /api/v1/video_enhance/create-job

  with Form Data:

  • target_video_url

    : The video public URL from step 6

  • file_name

    : Original file name

  • user_video_duration

    : Video duration in seconds

  • job_type

    : "video-enhance"

  • is_hd

    : true/false (HD mode for higher quality)

8. Poll Job Status

• Every 5 seconds call

  /api/v1/jobs/list-jobs?job_ids=xxx

  to query status
• Status: PENDING → PROCESSING → COMPLETED/FAILED
• Show progress percentage

9. Return Result

• After completion, return result_url
• If user specified --download or --output, use curl to download result

Credit Consumption

Supported Video Formats

• MP4
• MOV
• AVI
• MKV
• WebM

Example Conversation

1. Parse arguments - local video, normal mode
2. Get video duration
3. Call API to get user info
4. Check credits sufficient (duration × 1 credit/sec)
5. Upload video to R2
6. Create video enhancement job
7. Poll for completion
8. Return result URL

1. Parse arguments - remote video, HD mode, trim 5-15s
2. Download video using yt-dlp
3. Trim video to 10 seconds
4. Get trimmed video duration
5. Check credits sufficient (10 sec × 3 credits/sec = 30 credits)
6. Upload trimmed video to R2
7. Create video enhancement job with is_hd=true
8. Poll for completion
9. Return result URL

Notes

• This skill uses yt-dlp for remote video downloads (YouTube, Bilibili, etc.)
• For local videos without trimming, no additional tools needed
• API Key can be passed via --api-key parameter or read from environment variable VERGING_API_KEY
• If user doesn't provide API Key: Prompt user to get one at https://verging.ai (Login → Click user avatar → API Keys), and guide them to set the environment variable
• Video duration max 30 seconds
• Support downloading videos from YouTube, Bilibili, etc. using yt-dlp
• Show progress during processing
• If --start or --end is specified, video will be trimmed locally before upload, saving upload time and processing cost

Privacy and Security

API Key

1. Visit https://verging.ai
2. Login → Click user avatar (top right) → Select "API Keys"
3. Create a new API key

• Use a dedicated API key with minimal permissions
• Never expose your API key in public repositories
• Set it via environment variable:

  export VERGING_API_KEY="your_key"

Data Handling

• Video uploads: Videos are uploaded to verging.ai's R2 storage for processing
• Temporary files: Local temporary files are stored in

  /tmp/verging-video-enhancement/

  and cleaned up after processing
• Result videos: Processed videos are returned via a public URL
• No data retention: This skill does not store any user data beyond the session

Legal Notice

• Only process media you have rights to
• Use responsibly and ethically