Video Enhancement

Environment Variables

API Endpoints

Authentication

All API requests require authentication via the Authorization header:

Authorization: ApiKey <your_api_key>

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

Example:

# ✅ Correct
Authorization: ApiKey vrg_sk_123456...

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

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

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

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.):
  • 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

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

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

Example Conversation

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

You:

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

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

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