Transform Images into Dynamic Videos with thudm/cogvideox-i2v Cognitive Actions

23 Apr 2025
Transform Images into Dynamic Videos with thudm/cogvideox-i2v Cognitive Actions

In the age of rapid content creation, the ability to convert static images into engaging videos can significantly enhance user experience. The thudm/cogvideox-i2v API provides developers with powerful Cognitive Actions that leverage advanced AI models to transform images into dynamic video content. This blog post will explore how to utilize these pre-built actions effectively, unlocking the potential for creativity and automation in your applications.

Prerequisites

Before diving into the integration of Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform. This is crucial for authenticating your requests.
  • Basic familiarity with making API calls and handling JSON data.

Authentication Concept: Authentication typically involves passing your API key in the headers of your requests, ensuring secure access to the functionality provided by the Cognitive Actions platform.

Cognitive Actions Overview

Generate Video from Image

Description: This action transforms an input image into a dynamic video using the CogVideoX AI model. It utilizes image-to-video diffusion models along with an expert transformer to create compelling videos with customizable frames, guidance scales, and inference steps.

Category: Video Generation

Input

The input for this action requires the following fields:

  • image (string, required): A URI pointing to the input image that will serve as the base for video generation.
  • prompt (string, optional): Text that describes the desired output. If not provided, it defaults to "Starry sky slowly rotating."
  • guidanceScale (number, optional): A multiplier for classifier-free guidance, affecting how closely the output adheres to the prompt. It must be between 1 and 20, defaulting to 6.
  • numberOfFrames (integer, optional): Total number of frames to be generated for the output video, defaulting to 49 frames.
  • numberOfInferenceSteps (integer, optional): The number of steps used during the denoising process. Must be between 1 and 500, with a default of 50.

Example Input:

{
  "image": "https://replicate.delivery/pbxt/Lf97CMO0Sz0sZ0IuQarZRT8TbcMz4pCurtiLSKWDBPSTMb1S/input.jpg",
  "prompt": "Starry sky slowly rotating.",
  "guidanceScale": 6,
  "numberOfFrames": 49,
  "numberOfInferenceSteps": 50
}

Output

Upon successful execution, this action returns a URL pointing to the generated video. The output will typically look like this:

Example Output:

https://assets.cognitiveactions.com/invocations/c325e288-ea03-4baa-b5f1-5379dba2e7b5/2375784c-f81b-45d1-987c-ee808c19badc.mp4

Conceptual Usage Example (Python)

Here’s how you might structure your Python code to call this action:

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 = "70464404-18d2-4035-8813-7fb41bb81578"  # Action ID for Generate Video from Image

# Construct the input payload based on the action's requirements
payload = {
    "image": "https://replicate.delivery/pbxt/Lf97CMO0Sz0sZ0IuQarZRT8TbcMz4pCurtiLSKWDBPSTMb1S/input.jpg",
    "prompt": "Starry sky slowly rotating.",
    "guidanceScale": 6,
    "numberOfFrames": 49,
    "numberOfInferenceSteps": 50
}

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 payload variable is constructed based on the required input fields, and the request is sent to a hypothetical endpoint. The response, if successful, contains the URL of the generated video.

Conclusion

The thudm/cogvideox-i2v Cognitive Actions enable developers to create captivating videos from images effortlessly. By leveraging these advanced AI capabilities, you can enhance your applications, providing users with unique and engaging content. Explore further use cases like video storytelling, personalized content creation, or automated marketing materials using these powerful tools! Happy coding!

← Back to All Articles