Generate Stunning Images with Cognitive Actions from jborgesdb/siranonoblegems

21 Apr 2025
Generate Stunning Images with Cognitive Actions from jborgesdb/siranonoblegems

In the world of image generation, the ability to create compelling visuals tailored to specific prompts is invaluable. The jborgesdb/siranonoblegems API provides a powerful Cognitive Action called Generate Image with Inpainting, which leverages advanced inpainting techniques to produce high-quality images based on user-defined parameters. This action allows developers to integrate sophisticated image generation capabilities into their applications with ease.

Prerequisites

Before diving into the integration of the Cognitive Actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic understanding of JSON formatting and API requests.

Authentication typically involves passing the API key in the headers of your request. This allows secure access to the Cognitive Actions functionality.

Cognitive Actions Overview

Generate Image with Inpainting

Purpose:
This action generates images using advanced inpainting techniques, allowing for detailed customization based on various model settings. It supports image mask URIs, offers a fast mode for optimized performance, and provides control over output quality. Developers can also specify customizable image dimensions and aspect ratios, making it a versatile tool for image generation.

Category: Image Generation

Input: The input schema requires the following fields:

  • prompt (required): A textual prompt that guides the image generation.
  • mask (optional): An image mask for inpainting mode.
  • image (optional): An input image for inpainting or image-to-image transformations.
  • model (optional): Model selection, defaulting to "dev".
  • width (optional): The width of the generated image (only applicable when aspect_ratio is set to custom).
  • height (optional): The height of the generated image (only applicable when aspect_ratio is set to custom).
  • aspectRatio (optional): Defines the aspect ratio of the generated image.
  • outputFormat (optional): The file format for output images (webp, jpg, png).
  • outputQuality (optional): The quality of the output image (0 to 100).
  • numberOfOutputs (optional): The number of images to generate (1 to 4).
  • (Additional fields include settings for prompt strength, guidance intensity, and more.)

Example Input:

{
  "model": "dev",
  "width": 800,
  "height": 1200,
  "prompt": "A close-up of the 3NOB%100 bracelet on the model's wrist, set against a studio background of muted earth tones for a high-end, sophisticated appeal.",
  "loraScale": 1,
  "aspectRatio": "9:16",
  "outputFormat": "webp",
  "outputQuality": 100,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "guidanceIntensity": 3,
  "additionalLoraScale": 1,
  "numberOfInferenceSteps": 38
}

Output: The action returns a URL pointing to the generated image based on the provided parameters. The expected output might look like this:

[
  "https://assets.cognitiveactions.com/invocations/ff12ce86-f951-4618-94fc-d29aa538c035/5a7dfdc0-2e70-4448-a53d-494e489583bd.webp"
]

Conceptual Usage Example (Python): Here’s how you can integrate this action into your application using 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 = "64e5340d-0917-415e-96c6-80674b73402c" # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "width": 800,
    "height": 1200,
    "prompt": "A close-up of the 3NOB%100 bracelet on the model's wrist, set against a studio background of muted earth tones for a high-end, sophisticated appeal.",
    "loraScale": 1,
    "aspectRatio": "9:16",
    "outputFormat": "webp",
    "outputQuality": 100,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "guidanceIntensity": 3,
    "extraLoraScale": 1,
    "numberOfInferenceSteps": 38
}

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, we replace the placeholders with your API key and specify the action ID for generating images. The payload is structured according to the input schema, ensuring that all required parameters are included.

Conclusion

The Generate Image with Inpainting Cognitive Action from the jborgesdb/siranonoblegems API offers a robust solution for developers looking to enhance their applications with image generation capabilities. By utilizing customizable prompts and advanced settings, you can create stunning visuals tailored to your specific needs. As you begin to integrate these actions, consider exploring additional use cases and experimenting with various parameters to unlock the full potential of this powerful tool. Happy coding!

← Back to All Articles