Transform Your Applications with Enhanced Image Generation Using biguloff/jason-stathanm Actions

24 Apr 2025
Transform Your Applications with Enhanced Image Generation Using biguloff/jason-stathanm Actions

In today's digital landscape, the ability to generate high-quality images programmatically is a game changer for developers. The “biguloff/jason-stathanm” API offers powerful Cognitive Actions that streamline the process of image creation, particularly through advanced inpainting techniques. These pre-built actions not only save time but also deliver impressive results by leveraging sophisticated models and adjustable parameters. In this article, we will explore one of the key actions available in this spec: Generate Enhanced Images with Inpainting.

Prerequisites

Before diving into the implementation, make sure you have the following:

  • An API key for the Cognitive Actions platform.
  • Familiarity with making HTTP requests and handling JSON data.
  • Basic understanding of image processing concepts.

Authentication typically involves passing your API key in the request headers, ensuring that you have the necessary permissions to utilize these actions.

Cognitive Actions Overview

Generate Enhanced Images with Inpainting

This action allows developers to create detailed images using advanced inpainting techniques. It provides adjustable settings such as aspect ratio, output format, and model selection. Optimized for both speed and quality, it features a fast generation option utilizing an fp8-optimized model.

Input

The input for this action requires a prompt and can also include various optional parameters. Below is a breakdown of the input schema:

{
  "prompt": "JSN in sport store, kodak, MAN.dmg",
  "model": "dev",
  "loraScale": 1,
  "numOutputs": 4,
  "aspectRatio": "9:16",
  "outputFormat": "png",
  "guidanceScale": 3,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 28
}
  • prompt (required): A textual description that guides the image generation.
  • model (optional): Choose between "dev" for optimal use of inference steps or "schnell" for faster processing.
  • numOutputs (optional): Specifies how many image outputs you want (1-4).
  • aspectRatio (optional): Defines the aspect ratio of the generated image.
  • outputFormat (optional): Select the desired format for the output images (webp, jpg, png).

Output

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

[
  "https://assets.cognitiveactions.com/invocations/dfb44a7d-9ca4-4dd3-9a77-4808cd7fb5ff/27895cd3-561b-4b4e-9f34-9fb96da53889.png",
  "https://assets.cognitiveactions.com/invocations/dfb44a7d-9ca4-4dd3-9a77-4808cd7fb5ff/34555695-94eb-4d83-ac53-707eb9bfa43d.png",
  "https://assets.cognitiveactions.com/invocations/dfb44a7d-9ca4-4dd3-9a77-4808cd7fb5ff/3b31e311-d8a6-4617-8d23-323a5417c2c8.png",
  "https://assets.cognitiveactions.com/invocations/dfb44a7d-9ca4-4dd3-9a77-4808cd7fb5ff/1ab89fd0-994b-4f50-9c61-82267a9a94d5.png"
]

Conceptual Usage Example (Python)

Below is a conceptual Python snippet demonstrating how to invoke this 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 = "e3cef59c-fe66-4587-aeec-345f0806ce9e" # Action ID for Generate Enhanced Images with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "JSN in sport store, kodak, MAN.dmg",
    "model": "dev",
    "loraScale": 1,
    "numOutputs": 4,
    "aspectRatio": "9:16",
    "outputFormat": "png",
    "guidanceScale": 3,
    "outputQuality": 90,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "numInferenceSteps": 28
}

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 "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The input payload is structured to match the action's schema, and the results can be printed in a readable format.

Conclusion

The Generate Enhanced Images with Inpainting action from the biguloff/jason-stathanm API opens up new possibilities for image generation in your applications. With its versatile settings and the ability to produce high-quality outputs quickly, developers can easily enhance their projects with visually appealing content. Consider experimenting with different parameters to fully leverage the power of this action, and explore further use cases that could benefit from image generation capabilities. Happy coding!

← Back to All Articles