Create Stunning Images with prunaai/sdxl-turbo Cognitive Actions

22 Apr 2025
Create Stunning Images with prunaai/sdxl-turbo Cognitive Actions

In today's digital landscape, the ability to generate images from textual descriptions is a powerful tool for developers. The prunaai/sdxl-turbo Cognitive Actions offer an efficient way to create high-quality images with customizable parameters. This article will guide you through the capabilities of the Generate Images from Text action, allowing you to integrate it seamlessly into your applications.

Prerequisites

Before you begin using the Cognitive Actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of handling API requests and JSON data.

To authenticate your requests, you'll typically need to pass the API key in the headers of your HTTP requests. This allows you to securely access the available actions.

Cognitive Actions Overview

Generate Images from Text

Description: This action creates high-quality images based on textual descriptions using the prunaai/sdxl-turbo model. It allows customization of image dimensions, guidance scale, and the number of images to generate, balancing precision and performance.

Category: Image Generation

Input

The input for this action requires the following fields:

  • prompt (required): A textual description of the image to be generated.
  • seed (optional): An integer for random number generation affecting output reproducibility. Default is 42.
  • imageWidth (optional): Width of the generated image in pixels. Default is 1024.
  • imageHeight (optional): Height of the generated image in pixels. Default is 1024.
  • guidanceScale (optional): A factor determining adherence to the prompt, with higher values leading to more accuracy. Default is 7.5.
  • numberOfImages (optional): The total number of distinct images to generate. Default is 1.
  • numberOfInferenceSteps (optional): The count of steps in the inference process affecting quality and computation time. Default is 50.

Example Input:

{
  "seed": 42,
  "prompt": "An astronaut riding a rainbow unicorn, cinematic, dramatic",
  "imageWidth": 768,
  "imageHeight": 768,
  "guidanceScale": 7.5,
  "numberOfImages": 1,
  "numberOfInferenceSteps": 25
}

Output

Upon successful execution, the action typically returns a URL pointing to the generated image.

Example Output:

https://assets.cognitiveactions.com/invocations/ede2f1dd-639d-44e3-9c3f-88d64be806d6/d33dd9ba-5230-40de-a95e-ed0a502420f3.png

Conceptual Usage Example (Python)

Here's how you might call this action using a hypothetical Cognitive Actions execution endpoint 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 = "b6c9128b-52c1-411f-9251-4c344b2fbefc"  # Action ID for Generate Images from Text

# Construct the input payload based on the action's requirements
payload = {
    "seed": 42,
    "prompt": "An astronaut riding a rainbow unicorn, cinematic, dramatic",
    "imageWidth": 768,
    "imageHeight": 768,
    "guidanceScale": 7.5,
    "numberOfImages": 1,
    "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 code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload is structured according to the input requirements of the action. The URL and request structure shown are illustrative; make sure to adapt them based on the actual API documentation.

Conclusion

The Generate Images from Text action within the prunaai/sdxl-turbo Cognitive Actions opens up exciting possibilities for developers looking to integrate image generation into their applications. By harnessing the power of textual descriptions, you can create stunning visuals that enhance user experience and engagement.

Explore further use cases such as generating artwork, educational materials, or even marketing content. The potential is vast, and with these tools at your disposal, you can bring your creative ideas to life!

← Back to All Articles