SkillHub

alibaba-super-resolution

v0.1.0

Enhance video resolution using Alibaba Cloud Super Resolution API. Use when the user wants to: (1) upscale low-res videos to higher resolution, (2) improve video quality before publishing, or (3) convert 480p videos to 1080p.

Sourced from ClawHub, Authored by BlackEight4752

Installation

Please help me install the skill `alibaba-super-resolution` from SkillHub official store. npx skills add BlackEight4752/alibaba-super-resolution

Alibaba Cloud Super Resolution (阿里云视频超分辨率)

Enhance video resolution using Alibaba Cloud's video super resolution API, converting low-resolution videos to higher resolution (e.g., 480p → 960p).

Prerequisites

Set the following environment variables for authentication:

export ALIBABA_CLOUD_ACCESS_KEY_ID="your-access-key-id"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your-access-key-secret"

Optional OSS Configuration (for large files)

For files larger than 2GB or when using OSS directly:

export ALIYUN_OSS_BUCKET="your-bucket-name"
export ALIYUN_OSS_ENDPOINT="oss-cn-shanghai.aliyuncs.com"

Execution (Python CLI Tool)

A Python CLI tool is provided at ~/.openclaw/workspace/skills/alibaba-super-resolution/alibaba_super_resolve.py.

Quick Examples

# Basic usage: local file → local HD file
python3 ~/.openclaw/workspace/skills/alibaba-super-resolution/alibaba_super_resolve.py 
  --input videos/input-480p.mp4 
  --output videos/output-960p.mp4

# Custom bit rate (higher = better quality, larger file)
python3 ~/.openclaw/workspace/skills/alibaba-super-resolution/alibaba_super_resolve.py 
  --input videos/input-480p.mp4 
  --output videos/output-960p.mp4 
  --bit-rate 8

# Do not wait for completion (return job ID immediately)
python3 ~/.openclaw/workspace/skills/alibaba-super-resolution/alibaba_super_resolve.py 
  --input videos/input-480p.mp4 
  --no-wait

# Check status of an existing job
python3 ~/.openclaw/workspace/skills/alibaba-super-resolution/alibaba_super_resolve.py 
  --status <JOB_ID>

# Wait for an existing job and download result
python3 ~/.openclaw/workspace/skills/alibaba-super-resolution/alibaba_super_resolve.py 
  --wait <JOB_ID> 
  --output videos/output-960p.mp4

Input Requirements

Video Files

  • Formats: MP4, MOV, AVI, MKV
  • Max Size: 2GB (direct upload) / No limit (OSS URL)
  • Max Duration: 30 minutes
  • Input Resolutions: 480p, 720p

Output Resolutions

Input Output
480p 960p (2x upscale)
720p 2K (2x upscale)

Bit Rate Settings

Bit Rate Quality File Size Processing Time Use Case
1-3 Low Small Fast Preview/Testing
4-6 Medium Medium Medium Social Media
7-10 High Large Slow HD Publishing

Rules

  1. Always check that credentials are configured before making API calls.
  2. Files over 2GB must use OSS URL instead of direct upload.
  3. Default bit rate: 5 (balanced quality/size).
  4. Default timeout: 1200 seconds (20 minutes).
  5. Download immediately - output URLs expire after 24 hours.
  6. Handle errors gracefully - display clear error messages.

Troubleshooting

VideoTooLarge

Error: File exceeds 2GB limit

Fix: Use OSS URL instead of direct upload

Timeout

Error: Task timed out

Fix: Increase timeout parameter: --timeout 1800 (30 minutes)

OSSAccessDenied

Error: OSSAccessDenied

Fix: Verify RAM permissions for the access key, ensure it has OSS read/write access.

  • Alibaba Cloud Super Resolution Docs