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:

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

```bash
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

```bash
# 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...

# ☁️ Alibaba Cloud Super Resolution

阿里云视频超分辨率 Skill
本技能调用阿里云视频超分辨能力，可以将输入视频放大2倍尺寸输出，并基于细节推断增强输出视频画质，输出视频为h264编码、MP4格式；

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-blue)](https://github.com/openclaw/openclaw)

[阿里云超级分辨率官方文档](https://help.aliyun.com/zh/viapi/developer-reference/api-w2n4j6?spm=5176.30275541.J_ZGek9Blx07Hclc3Ddt9dg.1.23722f3dIyTr4v&scm=20140722.S_help@@%E6%96%87%E6%A1%A3@@159118._.ID_help@@%E6%96%87%E6%A1%A3@@159118-RL_%E8%B6%85%E7%BA%A7%E5%88%86%E8%BE%A8%E7%8E%87-LOC_2024SPAllResult-OR_ser-PAR1_215029ae17731433060538338d0c65-V_4-PAR3_o-RE_new13-P0_0-P1_0)


## ✨ 功能特性

- 🎬 **AI 超分**：将低分辨率视频（≤720p）提升至2x分辨率
- 📤 **本地上传**：支持本地文件直接上传（最大 2GB）
- ⚙️ **灵活配置**：可自定义码率，平衡质量和文件大小
- 🔄 **异步处理**：支持后台任务、状态查询、自动下载

## 📦 快速开始

### 鉴权文件
[创建AccessKey](https://help.aliyun.com/zh/viapi/getting-started/create-the-accesskey?spm=a2c4g.11186623.0.0.317c257fqUr1bO)

获取AccessKey ID与AccessKey Secret

### 阿里云SDK
本API调用依赖阿里云SDK

# SDK安装命令:
pip install alibabacloud_videoenhan20200320==4.0.0

### 技能安装

```bash
# 方式 1: 克隆到 OpenClaw skills 目录
cd ~/.openclaw/workspace/skills
git clone https://github.com/BlackEight4752/alibaba-super-resolution.git

# 方式 2: 通过 ClawHub（待发布）
clawhub install alibaba-super-resolution

# 安装依赖
pip install -r requirements.txt
```

### 配置 API 密钥

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

# 可选：OSS 配置（用于大文件）
export ALIYUN_OSS_BUCKET="your-bucket-name"
export ALIYUN_OSS_ENDPOINT="oss-cn-shanghai.aliyuncs.com"
```

### 使用示例

```bash
# 基础用法：本地文件 → 本地 HD 文件
python3 ~/.openclaw/workspace/skills/alibaba-super-resol...