Generate Stunning Images with the joezboom/yossiimages Cognitive Actions

24 Apr 2025
Generate Stunning Images with the joezboom/yossiimages Cognitive Actions

In today’s digital landscape, the demand for high-quality images is ever-increasing. The joezboom/yossiimages Cognitive Actions provide developers with powerful tools to generate stunning images using advanced techniques like inpainting. These pre-built actions simplify the process of image generation, enabling developers to leverage sophisticated models with customizable parameters. In this article, we will delve into the capabilities of the Generate Image with Inpainting action and provide practical guidance on integrating it into your applications.

Prerequisites

Before you can start using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and API calls.
  • A Python environment set up to run the provided code examples.

To authenticate your requests, you will typically pass the API key in the headers of your HTTP requests.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action allows for the creation of high-quality images using either a base or optimized speed model while enabling inpainting for specific areas of the image. This action is particularly useful for generating images that require customization, such as altering existing images or generating entirely new ones based on prompts.

Input

The input to this action requires a JSON object with the following properties:

  • prompt (required): A detailed description of the image to be generated.
  • model (optional): Specifies the model for inference, with options like dev or schnell.
  • loraScale (optional): Adjusts the intensity of the main LoRA application.
  • outputFormat (optional): Defines the image format for outputs (e.g., webp, jpg, png).
  • guidanceScale (optional): Affects how closely the output adheres to the prompt.
  • outputQuality (optional): Sets the quality level of the output images.
  • numberOfOutputs (optional): Specifies how many images to return (up to 4).
  • imageAspectRatio (optional): Determines the aspect ratio of the generated image.

Here is an example of the required input JSON structure:

{
  "model": "dev",
  "prompt": "a professional headshot of Yossi during a business photoshoot...",
  "loraScale": 1,
  "outputFormat": "webp",
  "guidanceScale": 3.01,
  "outputQuality": 90,
  "numberOfOutputs": 4,
  "imageAspectRatio": "16:9"
}

Output

The output of this action consists of an array of URLs pointing to the generated images. Each URL directs to the respective image file. Here’s an example of the expected output:

[
  "https://assets.cognitiveactions.com/invocations/03480511-148f-4333-8d07-29d6fbd2e838/acfcde67-2d13-4d7f-acec-d7683e2a5fbf.webp",
  "https://assets.cognitiveactions.com/invocations/03480511-148f-4333-8d07-29d6fbd2e838/ae359309-7965-4c51-8577-b252dc9a48c0.webp",
  "https://assets.cognitiveactions.com/invocations/03480511-148f-4333-8d07-29d6fbd2e838/7bca4e94-a92f-4281-a7f3-9911a90ecf63.webp",
  "https://assets.cognitiveactions.com/invocations/03480511-148f-4333-8d07-29d6fbd2e838/4f50b18f-da6d-4c07-acae-1b02dfbeeff4.webp"
]

Conceptual Usage Example (Python)

To help you get started, here’s a conceptual Python snippet demonstrating how to call the Generate Image with Inpainting 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 = "f0480958-0a6c-465f-a96d-806eace8876c" # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "a professional headshot of Yossi during a business photoshoot...",
    "loraScale": 1,
    "outputFormat": "webp",
    "guidanceScale": 3.01,
    "outputQuality": 90,
    "numberOfOutputs": 4,
    "imageAspectRatio": "16:9"
}

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 corresponds to the Generate Image with Inpainting action, and the payload is structured to match the required input schema. The endpoint URL and request structure are illustrative and may differ in your implementation.

Conclusion

The joezboom/yossiimages Cognitive Actions offer a powerful way to generate high-quality images tailored to your specifications. By leveraging the Generate Image with Inpainting action, developers can create stunning visuals that meet various requirements. We encourage you to experiment with different prompts and parameters to unlock the full potential of this action in your projects. Happy coding!

← Back to All Articles