Generate Stunning Custom Images with eddie87/nedser Cognitive Actions

23 Apr 2025
Generate Stunning Custom Images with eddie87/nedser Cognitive Actions

In the world of digital creativity, the ability to generate custom images based on unique prompts can greatly enhance applications in various fields such as gaming, marketing, and content creation. The eddie87/nedser API offers a powerful Cognitive Action designed to transform text prompts into visually stunning images. By using this pre-built action, developers can save time and leverage advanced image generation capabilities without the need for extensive machine learning knowledge.

Prerequisites

Before you start integrating the Cognitive Actions from the eddie87/nedser API, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests.
  • Familiarity with JSON data format.

To authenticate your requests, you will typically pass the API key in the request headers. This allows secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Custom Images

The Generate Custom Images action enables developers to create custom images using a specified prompt and optional parameters for enhanced control over the output. This action is categorized under image-generation and supports various configurations to tailor the output according to your needs.

Input

The input for this action is structured as a JSON object. Here are the required and optional fields:

  • Required:
    • prompt: A string that describes the desired image. For example, "Nedser_OH as a samurai warrior with sword fighting ninjas. Captured in cinematic realism, the scene uses high-contrast lighting."
  • Optional:
    • mask: URI for an image mask used in inpainting mode.
    • seed: Integer for setting a random seed to reproduce results.
    • image: URI for an input image for image-to-image or inpainting modes.
    • width: Integer specifying the width of the generated image (256 to 1440).
    • height: Integer specifying the height of the generated image (256 to 1440).
    • goFast: Boolean that enables faster predictions.
    • guidanceScale: A number to control the guidance during image generation (0 to 10).
    • imageAspectRatio: Aspect ratio of the generated image (e.g., "1:1", "16:9").
    • numberOfOutputs: Integer for the number of images to generate (1 to 4).
    • imageOutputFormat: Format of the output image (e.g., "jpg", "png").
    • Additional parameters for fine-tuning the output quality and characteristics.

Here is an example input payload:

{
  "width": 1440,
  "height": 1440,
  "prompt": "Nedser_OH as a samurai warrior with sword fighting ninjas. Captured in cinematic realism, the scene uses high-contrast lighting.",
  "guidanceScale": 3.5,
  "mainLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "jpg",
  "numInferenceSteps": 28,
  "imageOutputQuality": 90,
  "additionalLoraScale": 1
}

Output

Upon executing this action successfully, you will receive a response containing the generated image URLs. Here’s an example output:

[
  "https://assets.cognitiveactions.com/invocations/44047803-5b36-4a15-bf94-73e8e8db35d1/1900850a-50fe-4cee-b290-6f16f1c17353.jpg"
]

This output provides links to the generated images, which can be displayed or further processed in your application.

Conceptual Usage Example (Python)

Here’s how you might use the Generate Custom Images action 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 = "5bae547e-5778-4c1f-93d5-c5d2e2a99cd8" # Action ID for Generate Custom Images

# Construct the input payload based on the action's requirements
payload = {
    "width": 1440,
    "height": 1440,
    "prompt": "Nedser_OH as a samurai warrior with sword fighting ninjas. Captured in cinematic realism, the scene uses high-contrast lighting.",
    "guidanceScale": 3.5,
    "mainLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "jpg",
    "numInferenceSteps": 28,
    "imageOutputQuality": 90,
    "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 snippet:

  • Replace the placeholder for your API key and the endpoint URL.
  • The action_id corresponds to the Generate Custom Images action.
  • The payload is constructed using the required and optional parameters outlined earlier.

Conclusion

The eddie87/nedser Cognitive Actions provide a robust solution for developers looking to integrate advanced image generation features into their applications. By utilizing the Generate Custom Images action, you can create unique visual content that enhances user engagement and creativity. Explore the possibilities of custom image generation and consider implementing this action in your next project!

← Back to All Articles