Enhance Your Videos with STAR Upscaler: A Developer's Guide

23 Apr 2025
Enhance Your Videos with STAR Upscaler: A Developer's Guide

In the world of multimedia applications, video quality is paramount. The STAR Upscaler, part of the zsxkib/star API, empowers developers to enhance low-quality videos by leveraging advanced spatial-temporal augmentation and text-to-video models. With this tool, you can improve resolution while ensuring that the temporal consistency remains intact. Utilizing optional text prompts, you can guide the enhancement process to achieve the desired output.

Prerequisites

Before diving into the integration of STAR Upscaler, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic understanding of JSON and HTTP requests.
  • Familiarity with Python for executing API calls.

Authentication typically involves passing your API key in the headers of your requests to access the Cognitive Actions endpoint.

Cognitive Actions Overview

Enhance Video with STAR Upscaler

The Enhance Video with STAR Upscaler action is designed to take low-quality video input and significantly enhance its resolution and quality. This is achieved through a series of processing steps that can be fine-tuned based on the specific needs of the video content.

Input

The input for this action requires the following fields:

  • video (string, required): URI of the input video file to be enhanced. The video should be appropriately formatted for processing.
  • steps (integer, optional): Specifies the number of diffusion steps for processing (default: 5). Range 1-5 for balanced output and 10-50 for extreme details.
  • prompt (string, optional): A detailed text description of the video content. This guides the enhancement process.
  • upscale (integer, optional): Super-resolution scaling factor (default: 4).
  • chunkSize (integer, optional): Number of frames processed in parallel batches (default: 3).
  • solverMode (string, optional): Determines the sampling strategy used ('fast' or 'normal'; default: 'normal').
  • guidanceScale (number, optional): Defines the strength of alignment between text and video (default: 7.5).
  • maxChunkLength (integer, optional): Size of frame groups for temporal processing (default: 24).

Example Input:

{
  "steps": 2,
  "video": "https://replicate.delivery/pbxt/MPyx99JPK5KknsPe31tsSGL79Noiq8asmC8re9rID8fagp2X/016_video.mp4",
  "prompt": "The video is a black-and-white silent film featuring two men in wheelchairs on a pier. The foreground man, in a suit and hat, holds a sign reading 'HELP A CRIPPLE.'",
  "upscale": 4,
  "chunkSize": 3,
  "solverMode": "normal",
  "guidanceScale": 7.5,
  "maxChunkLength": 24
}

Output

Upon successful execution, the action typically returns a URI of the enhanced video output.

Example Output:

https://assets.cognitiveactions.com/invocations/4578d230-1c26-4019-b886-5700a6e733b0/5f8cde4b-4acd-450b-a30a-14a0fc8ee9a1.mp4

Conceptual Usage Example (Python)

Here’s how you can call the STAR Upscaler in your application:

import requests
import json

# Replace with your Cognitive Actions API key and endpoint
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute" # Hypothetical endpoint

action_id = "5b75c99b-cee3-4bb0-8fac-aef14b9c05f6"  # Action ID for Enhance Video with STAR Upscaler

# Construct the input payload based on the action's requirements
payload = {
    "steps": 2,
    "video": "https://replicate.delivery/pbxt/MPyx99JPK5KknsPe31tsSGL79Noiq8asmC8re9rID8fagp2X/016_video.mp4",
    "prompt": "The video is a black-and-white silent film featuring two men in wheelchairs on a pier. The foreground man, in a suit and hat, holds a sign reading 'HELP A CRIPPLE.'",
    "upscale": 4,
    "chunkSize": 3,
    "solverMode": "normal",
    "guidanceScale": 7.5,
    "maxChunkLength": 24
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json"
}

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json={"action_id": action_id, "inputs": payload}  # Hypothetical structure
    )
    response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body: {e.response.text}")

In this code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID is used to specify the action you wish to execute, and the input payload is structured according to the requirements of the STAR Upscaler.

Conclusion

The STAR Upscaler provides a powerful tool for video enhancement, allowing developers to improve video quality efficiently. With customizable parameters, you can fine-tune the enhancement process to suit various use cases, from restoring classic films to enhancing modern video content. Start integrating STAR Upscaler into your applications today and elevate your video processing capabilities!

← Back to All Articles