Generate Stunning Progressive Images with Zeke's Haiku Cognitive Actions

22 Apr 2025
Generate Stunning Progressive Images with Zeke's Haiku Cognitive Actions

In the world of image generation, the "zeke/haiku-progressive-image" API offers a powerful tool for developers looking to create engaging and visually appealing content. The key feature of this API is its ability to generate images progressively, revealing one word at a time, which can be particularly useful for artistic applications, storytelling, or educational tools. By leveraging pre-built Cognitive Actions, developers can easily integrate this functionality into their applications without the need for extensive machine learning expertise.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and how to make HTTP requests.
  • Familiarity with Python, as we will use it for our conceptual usage examples.

For authentication, you will typically need to pass your API key in the headers of your requests, ensuring secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Progressive Image

The Generate Progressive Image action allows developers to create images that are revealed progressively, one word at a time. This action can derive background colors from a specified source image URI, enhancing the visual coherence of the output.

  • Category: Image Generation

Input

The input for this action is defined by the CompositeRequest schema, which includes the following properties:

  • seed (optional): An integer seed to ensure consistent results across requests. Must be a non-negative number.
  • sleep (optional): A number indicating the time in seconds to pause between emitting each word during the progressive output. Defaults to 0.1 seconds.
  • sourceImage (optional): A URI of an image from which the background color for the output image is derived.

Example Input:

{
  "sleep": 0.1
}

Output

The action typically returns an array of URLs, each pointing to a progressively generated image. Here is an example of the output structure:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/ccfa1bec-cca9-4f2a-b1ab-66d09e78ebbc/c186bb19-367e-4bb1-98eb-d2f0fa0b004f.png",
  "https://assets.cognitiveactions.com/invocations/ccfa1bec-cca9-4f2a-b1ab-66d09e78ebbc/b0027327-e7a1-4185-bb8d-75c0d103b56a.png"
  // Additional URLs would follow
]

Conceptual Usage Example (Python)

Here’s how a developer might invoke the Generate Progressive Image action 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 = "6f16a30c-8f55-42ae-97a0-37b7a226a8bf"  # Action ID for Generate Progressive Image

# Construct the input payload based on the action's requirements
payload = {
    "sleep": 0.1
}

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 corresponds to the Generate Progressive Image action, and the payload is structured according to the input schema. The example demonstrates how to handle the response and errors appropriately.

Conclusion

The Generate Progressive Image action from the "zeke/haiku-progressive-image" API empowers developers to create visually stunning and interactive content. By utilizing the progressive generation feature, you can enhance user engagement in your applications. Explore the potential of this action in your projects, and consider integrating it into creative storytelling, educational tools, or artistic applications. Happy coding!

← Back to All Articles