Generate Stunning Images with the leohafi/simplicity1970_test Cognitive Actions

23 Apr 2025
Generate Stunning Images with the leohafi/simplicity1970_test Cognitive Actions

In the realm of artificial intelligence, image generation has become an exciting frontier, allowing developers to create high-quality visuals tailored to specific prompts. The leohafi/simplicity1970_test Cognitive Actions provide a robust API for generating images using advanced prediction models. With features like customizable parameters and support for various formats, these actions empower developers to integrate sophisticated image generation capabilities into their applications.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of JSON and RESTful APIs.
  • Familiarity with Python for executing the example code snippets.

Authentication is typically managed by passing your API key in the request headers, ensuring secure access to the Cognitive Actions services.

Cognitive Actions Overview

Generate Image with Prediction Models

The Generate Image with Prediction Models action enables developers to create high-quality images using either the 'dev' or 'schnell' models. This action supports adjustable parameters, including prompt strength, LoRA scale, and fast mode for accelerated inference. It also accommodates various image formats and aspect ratios, providing reproducibility through seed settings.

Input

The input schema requires the following fields:

  • prompt (string, required): A descriptive text guiding the generated image's content.
  • seed (integer, optional): A random seed for consistent results across runs.
  • image (string, optional): An input image for image-to-image or inpainting mode.
  • width (integer, optional): The width of the generated image (when aspect ratio is custom).
  • height (integer, optional): The height of the generated image (when aspect ratio is custom).
  • loraScale (number, optional): Influence of the main LoRA on the generation process.
  • outputCount (integer, optional): Number of images to generate.
  • outputQuality (integer, optional): Quality of the output images (0 to 100).
  • inferenceModel (string, optional): Selects the inference model to use ('dev' or 'schnell').
  • imageAspectRatio (string, optional): Specifies the aspect ratio of the generated image.
  • imageOutputFormat (string, optional): Format of the output images (webp, jpg, png).
  • inferenceStepCount (integer, optional): Number of denoising steps during generation.

Example Input:

{
  "seed": 34466,
  "width": 1440,
  "height": 1440,
  "prompt": "SMPLPTRN, illustration, vintage sketch style, tennis court top down view, pale colors, tennis net throws shadow, cropped image",
  "loraScale": 1,
  "outputCount": 1,
  "outputQuality": 90,
  "directionScale": 3.5,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "inferenceStepCount": 28,
  "additionalLoraScale": 1
}

Output

The output of this action typically includes a URL to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/bbe55373-f906-4a5a-8eea-299fc3b1bbfc/6eb0e44b-85af-4644-ba05-868ee19799d3.webp"
]

Conceptual Usage Example (Python)

Here is a conceptual Python code snippet demonstrating how to call the Generate Image 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 = "596c6489-7138-4d9f-9aef-583eb26ff562"  # Action ID for Generate Image with Prediction Models

# Construct the input payload based on the action's requirements
payload = {
    "seed": 34466,
    "width": 1440,
    "height": 1440,
    "prompt": "SMPLPTRN, illustration, vintage sketch style, tennis court top down view, pale colors, tennis net throws shadow, cropped image",
    "loraScale": 1,
    "outputCount": 1,
    "outputQuality": 90,
    "directionScale": 3.5,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "inferenceStepCount": 28,
    "additionalLoraScale": 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, replace the placeholder with your actual API key. The payload is structured according to the input schema, ensuring all necessary fields are included.

Conclusion

The leohafi/simplicity1970_test Cognitive Actions provide a powerful tool for developers looking to harness the capabilities of AI-driven image generation. By integrating these actions into your applications, you can create stunning visuals tailored to your specifications. As a next step, experiment with different parameters and inputs to see how they influence the generated results, and explore potential use cases in areas such as digital art, marketing, or content creation.

← Back to All Articles