Create Animated Videos from Text with chamuditha4/anime_diff-oolong Cognitive Actions

22 Apr 2025
Create Animated Videos from Text with chamuditha4/anime_diff-oolong Cognitive Actions

In today's fast-paced digital landscape, the ability to generate engaging visual content quickly is invaluable. The chamuditha4/anime_diff-oolong API offers a powerful Cognitive Action that allows developers to create animated videos directly from text prompts. This capability opens up a world of possibilities for applications in entertainment, education, and marketing, allowing for dynamic storytelling with minimal effort.

Prerequisites

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

  • An API key for the Cognitive Actions platform, which is crucial for authentication.
  • Basic knowledge of making HTTP requests and handling JSON data in your programming language of choice.

Authentication typically involves passing your API key in the request headers, which is essential for accessing the Cognitive Actions.

Cognitive Actions Overview

Generate Animated Video from Text

The Generate Animated Video from Text action enables the creation of animated videos by leveraging the AnimateDiff process. Users can specify various styles—including 'disney,' 'toony,' and 'realistic'—through descriptive text prompts.

Input

The input for this action is structured as follows:

  • seed (integer, optional): A random seed for generating content. If left blank, a randomized seed will be used.
  • model (string, optional): Specifies the model type for rendering. Options include 'disney', 'toony', or 'realistic'. Default is 'disney'.
  • width (integer, optional): The width of the output video in pixels (default: 512, range: 64 to 1024).
  • height (integer, optional): The height of the output video in pixels (default: 512, range: 64 to 1024).
  • prompt (string, required): A descriptive input that guides the video generation (e.g., "a panda playing a guitar, on a boat, in the ocean, high quality").
  • isVideo (boolean, optional): Indicates if the output is a video (default: true).
  • guidanceScale (number, optional): Guides adherence to the prompt (default: 7.5, range: 1 to 20).
  • negativePrompt (string, optional): A prompt that discourages specific qualities (default: "bad quality, worse quality").
  • numberOfFrames (integer, optional): Total number of frames in the video output (default: 16, range: 1 to 32).
  • numberOfInferenceSteps (integer, optional): Number of inference steps for refining the output (default: 25, range: 1 to 100).

Example Input:

{
  "prompt": "masterpiece, best quality, 1girl, solo, cherry blossoms, hanami, pink flower, white flower, spring season, wisteria, petals, flower, plum blossoms, outdoors, falling petals, white hair, black eyes",
  "guidanceScale": 7.5,
  "negativePrompt": "badhandv4, easynegative, ng_deepnegative_v1_75t, verybadimagenegative_v1.3, bad-artist, bad_prompt_version2-neg, teeth",
  "numberOfFrames": 24,
  "numberOfInferenceSteps": 25
}

Output

The action returns a URL pointing to the generated video, such as:

https://assets.cognitiveactions.com/invocations/64570710-2c76-4ced-9963-81fca1680948/b056662c-1796-4775-b001-84a2b529385c.mp4

This URL can be used to download or stream the animated content.

Conceptual Usage Example (Python)

Here's how a developer might implement the Generate Animated Video from Text action in 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 = "1e8b2d50-643c-42e4-b051-32d9e48f3804"  # Action ID for Generate Animated Video from Text

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "masterpiece, best quality, 1girl, solo, cherry blossoms, hanami, pink flower, white flower, spring season, wisteria, petals, flower, plum blossoms, outdoors, falling petals, white hair, black eyes",
    "guidanceScale": 7.5,
    "negativePrompt": "badhandv4, easynegative, ng_deepnegative_v1_75t, verybadimagenegative_v1.3, bad-artist, bad_prompt_version2-neg, teeth",
    "numberOfFrames": 24,
    "numberOfInferenceSteps": 25
}

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 snippet, the developer replaces the API key and endpoint with their own. They construct a payload using the required fields and send a POST request to the Cognitive Actions API. The output is handled gracefully, with error checking to ensure a smooth experience.

Conclusion

The Generate Animated Video from Text action from the chamuditha4/anime_diff-oolong API provides developers with a powerful tool for creating engaging animated content from simple text prompts. By leveraging this capability, you can enhance your applications and deliver rich user experiences. Consider experimenting with different prompts and parameters to see how you can creatively use this technology in your projects!

← Back to All Articles