Generate Stunning Images with the danielxies/annie Cognitive Actions

24 Apr 2025
Generate Stunning Images with the danielxies/annie Cognitive Actions

In the world of AI-driven creativity, the danielxies/annie spec offers a powerful set of Cognitive Actions that allow developers to harness advanced image generation capabilities. The primary action, Generate Image with Inpainting and Customization, enables users to create visually stunning images with a variety of customization options, making it an ideal solution for applications that require dynamic and engaging visual content.

Prerequisites

Before you dive into integrating the Cognitive Actions, ensure you have the following:

  • API Key: You will need an API key for the Cognitive Actions platform to authenticate your requests.
  • Setup: Have a development environment ready to make HTTP requests (e.g., Python with the requests library).

Authentication typically involves passing your API key in the request headers, allowing you to safely interact with the service.

Cognitive Actions Overview

Generate Image with Inpainting and Customization

Description: This operation generates images with specific customization options like inpainting, aspect ratio, and prompt intensity. It uses models optimized for speed and quality and integrates advanced features like LoRA for enhanced image generation.

  • Category: image-generation

Input

The input to this action requires a JSON object that adheres to the following schema:

{
  "prompt": "string",  // Required
  "mask": "string",    // Optional: URI for image mask
  "seed": "integer",   // Optional: Random seed
  "image": "string",   // Optional: Input image URI
  "model": "string",   // Optional: Model to use ("dev" or "schnell")
  "width": "integer",  // Optional: Width of the generated image
  "height": "integer", // Optional: Height of the generated image
  "fastMode": "boolean", // Optional: Enable fast mode
  ...
}

Example Input:

{
  "model": "dev",
  "prompt": "TOK A cartoon illustration of a whimsical night scene in a meadow under an indigo sky. The stars twinkle brightly, and the moon glows softly...",
  "imageFormat": "webp",
  "outputCount": 1,
  "imageQuality": 90,
  "loraIntensity": 1,
  "imageAspectRatio": "16:9",
  "inferenceStepsCount": 28,
  "promptEffectStrength": 0.8,
  "diffusionGuidanceScale": 3.5,
  "additionalLoraIntensity": 1
}

Output

The action typically returns a JSON array containing URLs of the generated images. An example output might look like this:

[
  "https://assets.cognitiveactions.com/invocations/0770c995-795b-4407-9d79-a3bbd73fd3e9/413d59e0-92c6-4360-b345-60d00a39ab25.webp"
]

Conceptual Usage Example (Python)

Here’s how you might structure a request to execute this 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 = "a64567dc-f4c0-4e25-8427-f289e8d265d1"  # Action ID for Generate Image with Inpainting and Customization

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "TOK A cartoon illustration of a whimsical night scene in a meadow under an indigo sky...",
    "imageFormat": "webp",
    "outputCount": 1,
    "imageQuality": 90,
    "loraIntensity": 1,
    "imageAspectRatio": "16:9",
    "inferenceStepsCount": 28,
    "promptEffectStrength": 0.8,
    "diffusionGuidanceScale": 3.5,
    "additionalLoraIntensity": 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 example, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The input payload is constructed based on the required parameters, and the action is executed with a POST request to the hypothetical endpoint.

Conclusion

The danielxies/annie Cognitive Actions empower developers to create customized and high-quality images effortlessly. By integrating these actions, you can enhance your applications with dynamic visual content tailored to your specific needs. Consider exploring additional use cases, such as generating images for marketing materials, enhancing creative projects, or even developing unique content for social media campaigns. Happy coding!

← Back to All Articles