Metadata-Version: 2.1
Name: videoupscaler-sdk
Version: 0.1.0
Summary: Official Python SDK & CLI for VideoUpscaler (https://videoupscaler.co) — 4K AI Video Upscaler, Batch Upscaling, Denoising, 60FPS Frame Interpolation & Workflow API
Home-page: https://videoupscaler.co
Author: VideoUpscaler Team
Author-email: support@videoupscaler.co
License: MIT
Keywords: video-upscaler,4k-video-upscaler,ai-video-enhancer,video-denoising,frame-interpolation,video-stabilization,n8n,mcp
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Video :: Conversion
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Project-URL: Homepage, https://videoupscaler.co
Project-URL: 4K Video Upscaler, https://videoupscaler.co/4k-video-upscaler
Project-URL: Batch Video Upscaler, https://videoupscaler.co/batch-video-upscaler
Project-URL: AI Video Denoising, https://videoupscaler.co/denoise-video
Project-URL: 60FPS Frame Interpolation, https://videoupscaler.co/frame-interpolation
Project-URL: AI Video Stabilization, https://videoupscaler.co/stabilize-video
Project-URL: Workflow Integrations, https://videoupscaler.co/integrations
Project-URL: API Documentation, https://videoupscaler.co/docs/workflows
Project-URL: Read the Docs, https://videoupscaler.readthedocs.io/en/latest/
Project-URL: Source Repository, https://github.com/arkyu2077/ai-video-upscaler

# VideoUpscaler Official Python SDK & CLI

[![Website](https://img.shields.io/badge/Website-videoupscaler.co-blue)](https://videoupscaler.co)
[![4K Upscaler](https://img.shields.io/badge/4K_Video_Upscaler-FlashVSR--4K-purple)](https://videoupscaler.co/4k-video-upscaler)
[![Workflows](https://img.shields.io/badge/Integrations-n8n_%7C_Make_%7C_Zapier_%7C_MCP-green)](https://videoupscaler.co/integrations)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.23913038.svg)](https://doi.org/10.5281/zenodo.23913038)

Official Python client library and CLI for **[VideoUpscaler (videoupscaler.co)](https://videoupscaler.co)** — the cloud-native **[4K AI Video Upscaler](https://videoupscaler.co/4k-video-upscaler)**, **[Batch Video Upscaler](https://videoupscaler.co/batch-video-upscaler)**, **[AI Video Denoising](https://videoupscaler.co/denoise-video)**, **[60FPS Frame Interpolation](https://videoupscaler.co/frame-interpolation)**, and **[AI Video Stabilization](https://videoupscaler.co/stabilize-video)** platform.

## Core Capabilities & Live Endpoints

| Pipeline | Live Endpoint | Description |
| :--- | :--- | :--- |
| **Core Platform** | [https://videoupscaler.co](https://videoupscaler.co) | Cloud AI Video Enhancement Studio & REST API |
| **4K AI Video Upscaler** | [https://videoupscaler.co/4k-video-upscaler](https://videoupscaler.co/4k-video-upscaler) | Multi-frame spatio-temporal super-resolution up to 3840x2160 UHD |
| **Batch Video Upscaler** | [https://videoupscaler.co/batch-video-upscaler](https://videoupscaler.co/batch-video-upscaler) | Parallel cloud queue for bulk video processing pipelines |
| **AI Video Denoising** | [https://videoupscaler.co/denoise-video](https://videoupscaler.co/denoise-video) | Low-light ISO sensor grain and H.264/H.265 compression artifact removal |
| **60FPS Frame Interpolation** | [https://videoupscaler.co/frame-interpolation](https://videoupscaler.co/frame-interpolation) | Optical-flow intermediate frame synthesis for smooth 60FPS playback |
| **AI Video Stabilization** | [https://videoupscaler.co/stabilize-video](https://videoupscaler.co/stabilize-video) | Camera trajectory smoothing and rolling-shutter correction |
| **Workflow Integrations** | [https://videoupscaler.co/integrations](https://videoupscaler.co/integrations) | Official n8n, Make.com, Zapier, and MCP AI Agent integrations |
| **API & Webhook Docs** | [https://videoupscaler.co/docs/workflows](https://videoupscaler.co/docs/workflows) | OpenAPI 3.1 specification, webhook signature verification, and SDK guides |

## Installation

```bash
pip install videoupscaler-sdk
```

## Quickstart

```python
from videoupscaler_sdk import VideoUpscalerClient

client = VideoUpscalerClient(api_key="your_api_key")

job = client.upscale(
    input_url="https://example.com/sora-clip-720p.mp4",
    scale=4,
    model="flashvsr-4k",
    denoise=True,
    target_fps=60,
    wait=25,
)
print("Status:", job["status"], "4K Output:", job.get("outputUrl"))
```

## Open-Source & Research Ecosystem

- **Read the Docs**: [https://videoupscaler.readthedocs.io/en/latest/](https://videoupscaler.readthedocs.io/en/latest/)
- **CERN Zenodo Technical Report (DOI)**: [https://doi.org/10.5281/zenodo.23913038](https://doi.org/10.5281/zenodo.23913038)
- **Hugging Face Space**: [https://huggingface.co/spaces/yuxh1996/4k-ai-video-upscaler](https://huggingface.co/spaces/yuxh1996/4k-ai-video-upscaler)
- **Hugging Face Model Card**: [https://huggingface.co/yuxh1996/VideoUpscaler-FlashVSR-4K](https://huggingface.co/yuxh1996/VideoUpscaler-FlashVSR-4K)
- **Replicate Model**: [https://replicate.com/aigc_hacker_house/4k-video-upscaler](https://replicate.com/aigc_hacker_house/4k-video-upscaler)
- **Kaggle Benchmark Dataset**: [https://www.kaggle.com/datasets/arkyu2077/4k-video-upscaling-benchmark](https://www.kaggle.com/datasets/arkyu2077/4k-video-upscaling-benchmark)
- **Postman Public API Workspace**: [https://www.postman.com/solar-escape-936981/workspace/videoupscaler-4k-ai-video-upscaler-api](https://www.postman.com/solar-escape-936981/workspace/videoupscaler-4k-ai-video-upscaler-api)
- **Docker Hub**: [https://hub.docker.com/r/dongdong1996/videoupscaler](https://hub.docker.com/r/dongdong1996/videoupscaler)
