Elevate Your Image Generation with jasonwallis777/dalesog2 Cognitive Actions

24 Apr 2025
Elevate Your Image Generation with jasonwallis777/dalesog2 Cognitive Actions

In the world of artificial intelligence and creative applications, generating high-quality images has become a key feature for many developers. The jasonwallis777/dalesog2 Cognitive Actions provide a powerful toolset for image generation using customizable parameters, including inpainting capabilities and diverse output formats. This article will guide you through the Generate Inpainted Image action, explaining how to leverage its features effectively in your applications.

Prerequisites

Before you start integrating the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests, especially POST requests.
  • Python installed on your machine for running the example code snippets.

Authentication typically involves passing your API key in the headers of your requests to access the Cognitive Actions endpoints.

Cognitive Actions Overview

Generate Inpainted Image

The Generate Inpainted Image action is designed to create images based on a text prompt and an optional image mask. This action allows for the generation of images with customizable parameters, such as model type, image dimensions, and quality enhancements through LoRA settings.

Input

The input for this action requires a JSON object according to the following schema:

  • prompt (required): A string that describes the image to generate. For example, "DALESOG2 on a picnic table with a delicious steak beside it."
  • mask (optional): A URI string for an image mask to enable inpainting mode.
  • image (optional): A URI string for an input image for inpainting.
  • width (optional): An integer specifying the width of the generated image, between 256 and 1440 pixels.
  • height (optional): An integer specifying the height of the generated image, between 256 and 1440 pixels.
  • aspectRatio (optional): A string for the aspect ratio of the image, e.g., "16:9".
  • numOutputs (optional): An integer specifying the number of images to generate (1 to 4).
  • outputFormat (optional): A string indicating the desired output format ("webp", "jpg", or "png").
  • guidanceScale (optional): A number controlling the guidance during generation (0 to 10).

Here is an example of the input JSON payload:

{
  "goFast": false,
  "prompt": "DALESOG2 on a picnic table with a delicious steak beside it.",
  "loraScale": 1,
  "numOutputs": 4,
  "aspectRatio": "16:9",
  "outputFormat": "webp",
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageResolution": "1",
  "numInferenceSteps": 28
}

Output

The action returns an array of URIs corresponding to the generated images. For example:

[
  "https://assets.cognitiveactions.com/invocations/4a120a63-7e4b-42d2-8ff4-1851010dca1b/2a563c1b-29ff-4c72-a655-76943aa23386.webp",
  "https://assets.cognitiveactions.com/invocations/4a120a63-7e4b-42d2-8ff4-1851010dca1b/eb9ae75b-d768-4369-8c83-4129429f45d2.webp",
  "https://assets.cognitiveactions.com/invocations/4a120a63-7e4b-42d2-8ff4-1851010dca1b/e5bf003e-4b4c-462d-a0e4-fd902cefbb63.webp",
  "https://assets.cognitiveactions.com/invocations/4a120a63-7e4b-42d2-8ff4-1851010dca1b/0e2390ab-7c64-40b0-948f-b420292e7c8b.webp"
]

Conceptual Usage Example (Python)

Here’s how you might structure a request to the Cognitive Actions endpoint 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 = "0f36aea4-dfee-496f-b4dd-f0471d10190f"  # Action ID for Generate Inpainted Image

# Construct the input payload based on the action's requirements
payload = {
    "goFast": False,
    "prompt": "DALESOG2 on a picnic table with a delicious steak beside it.",
    "loraScale": 1,
    "numOutputs": 4,
    "aspectRatio": "16:9",
    "outputFormat": "webp",
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "imageResolution": "1",
    "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 code snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID is set to the ID for the Generate Inpainted Image action. The payload is constructed according to the required input schema, and the request is sent to the hypothetical endpoint.

Conclusion

The jasonwallis777/dalesog2 Cognitive Actions offer developers a robust solution for generating images tailored to their specifications. By leveraging the flexibility of the Generate Inpainted Image action, you can create stunning visuals that meet your application's needs. Explore the possibilities, experiment with different parameters, and enhance your projects with this powerful tool. Happy coding!

← Back to All Articles