Revitalize Vintage Videos: Integrating DeOldify with Cognitive Actions

22 Apr 2025
Revitalize Vintage Videos: Integrating DeOldify with Cognitive Actions

In today's digital age, the desire to bring historical footage back to life is more prevalent than ever. The arielreplicate/deoldify_video API offers a powerful Cognitive Action that allows developers to enhance old video footage by adding color and improving quality. Leveraging machine learning, this action not only restores the vibrancy of videos but also ensures historical accuracy, making it an excellent tool for filmmakers, historians, and content creators alike.

Prerequisites

Before diving into the integration, ensure that you have the following:

  • An API key for the Cognitive Actions platform, which will be used to authenticate your requests.
  • The ability to make HTTP requests in your chosen programming language, as you'll need to send requests to the Cognitive Actions API.

Authentication typically involves passing your API key in the request headers, which allows you to securely access the Cognitive Actions functionalities.

Cognitive Actions Overview

Add Color to Old Video Footage

Purpose

This action utilizes DeOldify technology to infuse old black-and-white video footage with realistic colors. It aims to provide smooth, consistent, and flicker-free results, enhancing the visual appeal while preserving historical integrity.

Input

The input for this action requires a structured JSON object with the following fields:

  • inputVideo (required): A URI pointing to the video file you wish to enhance.
  • renderFactor (optional): An integer that determines the resolution for rendering colors. The default value is 21.

Example Input:

{
  "inputVideo": "https://replicate.delivery/pbxt/I9vNNmX3xjTMBVa1vq7GQIUlq8wPgJ1n0vF0dWg3tdVXYc9Y/chaplin_cut_small.mp4",
  "renderFactor": 21
}

Output

Upon successful execution, the action returns a URI link to the enhanced video. The output is typically a video file that has undergone colorization and quality enhancement.

Example Output:

https://assets.cognitiveactions.com/invocations/67e58b66-28f7-497a-8325-8034db1a7b07/eb13d560-40e9-4943-b636-08b51f21ffa4.mp4

Conceptual Usage Example (Python)

Here’s how you can call the Cognitive Actions execution endpoint using Python:

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 = "d686c260-7c46-4c63-99d6-23b319768722"  # Action ID for Add Color to Old Video Footage

# Construct the input payload based on the action's requirements
payload = {
    "inputVideo": "https://replicate.delivery/pbxt/I9vNNmX3xjTMBVa1vq7GQIUlq8wPgJ1n0vF0dWg3tdVXYc9Y/chaplin_cut_small.mp4",
    "renderFactor": 21
}

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 the above code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload is structured according to the action’s input requirements, and the endpoint URL is provided as a placeholder. This conceptual example illustrates how to format your request and handle responses.

Conclusion

The Add Color to Old Video Footage action from the arielreplicate/deoldify_video API allows developers to easily enhance vintage videos, making them more engaging for modern audiences. By integrating such Cognitive Actions into your applications, you can create innovative solutions that breathe new life into historical content. Consider exploring further applications, such as video restoration or archival projects, to fully leverage the capabilities of this powerful tool.

← Back to All Articles