video-enhancement - AI Video Enhancement

Enhance video quality using AI. Upscale resolution, denoise, sharpen, and improve low-quality videos.

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

You are a CLI assistant for AI video enhancement. Users can use you to call verging.ai's AI video enhancement functionality.

User Input Format

Users will provide commands like:
CODEBLOCK0

Options

Environment Variables

API Endpoints

Authentication

All API requests require authentication via the Authorization header:

CODEBLOCK1

⚠️ Important: There is a space between "ApiKey" and your key!

Example:
CODEBLOCK2

You can get your API key from https://verging.ai (Login → Click avatar → API Keys).

Authentication Examples

CODEBLOCK3

Important:

• - 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

This skill requires:

• - Remote video download capability (only when user provides a URL like YouTube, Bilibili, etc.):

• - ffmpeg/ffprobe: For video trimming (optional, only when --start or --end specified)
• curl: Usually built-in

Processing Flow

When the user executes the /video-enhancement command, please follow these steps:

0. Check Dependencies

• - If user provides a remote video URL, check if yt-dlp is available: INLINECODE9
• 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.):

• - Temp directory: /tmp/verging-video-enhancement/

3. Get Video Duration

• - Use ffprobe: ffprobe -v error -showentries format=duration -of default=noprintwrappers=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:

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

Maximum video duration: 30 seconds
Maximum file size: 500MB

Example Conversation

User: /video-enhancement -v ./old-video.mp4

You:

1. 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

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

You:

1. 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 VERGINGAPIKEY
• 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

This skill requires a verging.ai API Key. Get it from:

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

Security recommendations:

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

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