Generate Stunning Images with the cudanexus/stickergp Cognitive Actions

25 Apr 2025
Generate Stunning Images with the cudanexus/stickergp Cognitive Actions

In the world of application development, integrating advanced image generation capabilities can significantly enhance user experience. The cudanexus/stickergp API offers developers a powerful Cognitive Action that allows for the creation of images based on guided text prompts. This blog post will explore the Generate Image with Custom Settings action, detailing its inputs, outputs, and how to integrate it into your applications seamlessly.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of making API calls and handling JSON data.
  • A Python environment set up for testing your implementation.

Authentication is typically handled by passing your API key in the request headers, allowing you to securely access the Cognitive Actions you want to use.

Cognitive Actions Overview

Generate Image with Custom Settings

Description: This action allows you to create a generated image using guided text prompts. The action provides options for dimensions, upscaling, and other customization settings such as step count and random initialization.

Category: image-generation

Input

The input for this action requires a JSON object with several properties:

  • seed (integer): An integer used to initialize the random number generator for reproducibility. Use the same seed to get identical results.
  • steps (integer): The number of iterative steps the process takes. Default is 20.
  • width (integer): The width of the output image in pixels. Default value is 1024.
  • height (integer): The height of the output image in pixels. Default value is 1024.
  • prompt (string): A text prompt guiding the image generation process. Default is "a cute cat".
  • upscale (boolean): Boolean flag to enable 2x upscaling of the image. Default is true.
  • upscaleSteps (integer): Specifies the number of processing steps when upscaling. Only applicable if 'upscale' is true. Default is 10.
  • negativePrompt (string): A list of elements you want to exclude from the generated image. Default is an empty string.

Example Input:

{
  "steps": 20,
  "width": 1024,
  "height": 1024,
  "prompt": "a cute dog",
  "upscale": false,
  "upscaleSteps": 10,
  "negativePrompt": ""
}

Output

Upon successful execution, this action returns an array of URLs pointing to the generated images. Here’s an example of the output you might receive:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/dbceb57b-78ef-4217-a40e-9b2ba9887492/85c7c552-ada9-485e-abf2-4e685174023c.png",
  "https://assets.cognitiveactions.com/invocations/dbceb57b-78ef-4217-a40e-9b2ba9887492/cd730cc4-de0a-4172-bf3f-4c5fa64ac52b.png"
]

Conceptual Usage Example (Python)

Here is a conceptual Python code snippet demonstrating how to call the Generate Image with Custom Settings action using the hypothetical Cognitive Actions execution endpoint:

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 = "2b1a4b42-b1c7-45e7-b7a4-5e169cd50795" # Action ID for Generate Image with Custom Settings

# Construct the input payload based on the action's requirements
payload = {
    "steps": 20,
    "width": 1024,
    "height": 1024,
    "prompt": "a cute dog",
    "upscale": False,
    "upscaleSteps": 10,
    "negativePrompt": ""
}

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 for the image generation is set, and the input payload is structured based on the action's input schema. The response from the server will include URLs of the generated images.

Conclusion

The Generate Image with Custom Settings action from the cudanexus/stickergp API offers a straightforward way to generate stunning images tailored to your application’s needs. By leveraging the flexibility of customizable parameters, developers can create unique visuals that engage users effectively. Next, consider experimenting with different prompts and settings to unlock the full potential of this powerful tool!

← Back to All Articles