Create Stunning Custom Images with gymdreams8/gdmjp1 Cognitive Actions

23 Apr 2025
Create Stunning Custom Images with gymdreams8/gdmjp1 Cognitive Actions

In the realm of image generation, the gymdreams8/gdmjp1 API offers powerful Cognitive Actions that enable developers to create unique and tailored images based on user-defined prompts. This API harnesses advanced image processing techniques, allowing for a high degree of customization in size, style, and output variations. By leveraging these pre-built actions, developers can integrate sophisticated image generation capabilities into their applications without the need for extensive machine learning expertise.

Prerequisites

Before diving into the Cognitive Actions, ensure you have the following prerequisites in place:

  • API Key: You will need an API key to authenticate your requests to the Cognitive Actions platform. Generally, this involves including the API key in the request headers.
  • Basic Understanding of JSON: Familiarity with JSON formatting will be helpful as the input and output data structures are defined in this format.

Authentication typically requires passing the API key as a bearer token in the headers of your requests.

Cognitive Actions Overview

Generate Custom Image

The Generate Custom Image action creates a custom image based on user-defined prompts and specifications. It allows for adjustments in size, style refinement, and various output options, including watermarking for verification.

  • Category: image-generation

Input

The input for this action is structured as a JSON object, which includes several configurable properties. Below is a breakdown of the required and optional fields:

  • prompt (string): Text describing the desired output. (Example: "one man working out at the gym, in the style of gdmjp1...")
  • width (integer): The width of the output image in pixels. (Default: 1024)
  • height (integer): The height of the output image in pixels. (Default: 1024)
  • refine (string): Select the style refinement to apply. (Default: "no_refiner")
  • loraScale (number): Scale for Low-Rank Adaptation applied to trained models. (Default: 0.6)
  • scheduler (string): Select the scheduler algorithm for denoising. (Default: "K_EULER")
  • guidanceScale (number): Classifier-free guidance scale factor. (Default: 7.5)
  • applyWatermark (boolean): Determines if a watermark is applied. (Default: true)
  • promptStrength (number): Strength of the prompt. (Default: 0.8)
  • numberOfOutputs (integer): The number of images to generate. (Default: 1, Maximum: 4)
  • negativeInputPrompt (string): Specify negative attributes or styles to avoid. (Default: "")
  • numberOfInferenceSteps (integer): The number of denoising steps to perform. (Default: 50)

Here’s an example of a JSON payload that a developer might use:

{
  "width": 1024,
  "height": 1024,
  "prompt": "one man working out at the gym, in the style of gdmjp1, perfect face, perfect eyes, big feet, sneakers, shorts, shirtless",
  "refine": "no_refiner",
  "loraScale": 0.6,
  "scheduler": "KarrasDPM",
  "guidanceScale": 7.5,
  "applyWatermark": true,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "negativeInputPrompt": "monochrome, black and white, over saturation",
  "numberOfInferenceSteps": 50
}

Output

Upon successful execution, the action returns a URL pointing to the generated image. For example:

[
  "https://assets.cognitiveactions.com/invocations/720596c9-b609-43ed-be93-f5f6e413901a/5e7863f2-ab13-4656-8ae9-78b041afdc51.png"
]

This URL can be used to access the generated image directly.

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet to demonstrate how a developer might call the Generate Custom 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 = "1d195692-4ddf-41f3-9b6a-6c0494281ade"  # Action ID for Generate Custom Image

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "one man working out at the gym, in the style of gdmjp1, perfect face, perfect eyes, big feet, sneakers, shorts, shirtless",
    "refine": "no_refiner",
    "loraScale": 0.6,
    "scheduler": "KarrasDPM",
    "guidanceScale": 7.5,
    "applyWatermark": True,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "negativeInputPrompt": "monochrome, black and white, over saturation",
    "numberOfInferenceSteps": 50
}

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 snippet:

  • Replace the COGNITIVE_ACTIONS_API_KEY and COGNITIVE_ACTIONS_EXECUTE_URL with your actual API key and endpoint.
  • The action_id corresponds to the Generate Custom Image action.
  • The payload is structured according to the input schema outlined above.

Conclusion

The gymdreams8/gdmjp1 Cognitive Actions empower developers to easily integrate advanced image generation capabilities into their applications. By utilizing the Generate Custom Image action, you can create unique visuals tailored to specific prompts, enhancing your applications' functionality and user engagement. As you explore these capabilities, consider various use cases, from generating promotional images to creating custom artwork, and unlock the potential of AI-driven creativity in your projects.

← Back to All Articles