image-generation

Effortless Image Generation with Steppae Cognitive Actions

25 Apr 2025
Effortless Image Generation with Steppae Cognitive Actions

In the fast-paced world of digital content creation, having the ability to generate high-quality images quickly can significantly enhance productivity. Steppae offers a powerful Cognitive Action that allows developers to perform image generation using custom prompts and various parameters. This action not only supports different output formats but also provides options for speed and quality, making it an essential tool for those looking to integrate image generation into their applications.

Imagine being able to create unique illustrations, marketing visuals, or personalized graphics on demand. With Steppae's image generation capabilities, you can transform text prompts into stunning visual content tailored to your specifications. Whether you're building a game, designing a website, or creating social media content, this action can simplify your workflow and elevate your creative projects.

Prerequisites

Before diving into the integration of Steppae's image generation action, ensure you have a Cognitive Actions API key and a basic understanding of making API calls.

Execute Image Generation

The Execute Image Generation action is designed to create images based on user-defined prompts and parameters. By specifying details such as dimensions, aspect ratio, and output format, you can produce tailored visual content that meets your needs.

Purpose

This action solves the challenge of generating images quickly and efficiently, allowing developers to focus on creative aspects rather than the technicalities of image production. By leveraging customizable parameters, users can achieve a wide range of outputs that align with their specific requirements.

Input Requirements

To use this action, you need to provide a structured input that includes the following key parameters:

  • prompt: A descriptive text that guides the image generation process.
  • model: Choose between 'dev' for detailed results or 'schnell' for faster outputs.
  • aspectRatio: Select from predefined ratios or set a custom dimension.
  • height and width: Define the size of the generated image (if aspect ratio is custom).
  • outputFormat: Determine the format of the output image (e.g., png, jpg).

For a comprehensive list of input parameters, refer to the input schema.

Expected Output

The output will consist of a URL linking to the generated image. For example, a successful request may return:

  • "https://assets.cognitiveactions.com/invocations/673f2d8b-0d14-41ea-bfbc-7244f8b86e66/98452912-2a4d-4920-be53-79321df0a8a5.png"

Use Cases for Execute Image Generation

  1. Creative Projects: Artists and designers can quickly generate illustrations from textual descriptions, enabling rapid prototyping and concept development.
  2. E-commerce: Online retailers can create product images based on descriptions, enhancing their catalogs without needing extensive photography resources.
  3. Gaming: Game developers can produce unique character designs or environments based on narrative prompts, enriching the gaming experience.
  4. Marketing: Marketers can generate tailored visuals for campaigns, ensuring that promotional materials are engaging and relevant.

With the flexibility to customize various parameters, this action provides developers with a robust tool for creating stunning visuals that align with their project goals.

import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "d9b4a0c9-1acf-439f-bce2-6d947b093559" # Action ID for: Execute Image Generation

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "height": 1155,
  "prompt": "Comic book illstration, running pose KYRA with pink medium short messy hair, wearing black leather full suit",
  "aspectRatio": "3:4",
  "loraStrength": 1.11,
  "outputFormat": "png",
  "guidanceScale": 10,
  "outputQuality": 90,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "additionalLoraStrength": 1,
  "numberOfInferenceSteps": 28
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

Steppae's image generation action is an invaluable asset for developers seeking to enhance their applications with custom visuals. By allowing for detailed input specifications and offering both speed and quality options, it empowers creators to produce high-quality images that meet diverse needs. As you explore the potential of this action, consider how it can streamline your workflows and elevate your projects. Begin integrating Steppae today to unlock a new realm of creative possibilities!

← Back to All Articles