Create Stunning Inpainted Images with juddisjudd/roxannec Cognitive Actions

23 Apr 2025
Create Stunning Inpainted Images with juddisjudd/roxannec Cognitive Actions

In the ever-evolving landscape of image processing, the juddisjudd/roxannec Cognitive Actions provide developers with powerful tools to create stunning visual content effortlessly. One of the standout features of this spec is the Generate Inpainted Image action, which allows for the generation of images based on prompts, with extensive customization options. Using these pre-built actions can significantly streamline the development process, enabling you to focus on building your application rather than reinventing the wheel.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of JSON and HTTP requests.
  • Familiarity with Python (or your preferred programming language) for making API calls.

To authenticate your requests, you’ll typically pass your API key in the request headers.

Cognitive Actions Overview

Generate Inpainted Image

The Generate Inpainted Image action creates inpainted images using a selected model and input prompt. This action allows various customizations, such as image dimensions, output format, and generation speed, making it versatile for different use cases.

Input

The input schema for this action requires the following fields:

  • prompt (required): A textual description of the image you want to generate.
  • mask (optional): A URI of the image mask for inpainting mode.
  • seed (optional): An integer for generating reproducible results.
  • image (optional): A URI of the input image for image-to-image or inpainting mode.
  • model (optional): Choose between "dev" (default) and "schnell" for different inference speeds.
  • width and height (optional): Specify dimensions if using a custom aspect ratio.
  • additional customization options such as goFast, numberOfOutputs, imageAspectRatio, and outputImageQuality.

Example Input JSON:

{
  "model": "dev",
  "width": 1020,
  "height": 1350,
  "prompt": "a photo of ROX, a woman with a nose piercing, wearing a black shirt and earrings, looking at the camera with a smirk on her face",
  "loraIntensity": 1,
  "numberOfOutputs": 2,
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 3.5,
  "imageOutputFormat": "png",
  "inferenceStepCount": 35,
  "outputImageQuality": 100,
  "additionalLoraIntensity": 0.8
}

Output

The action returns an array of URLs pointing to the generated inpainted images. For example:

Example Output JSON:

[
  "https://assets.cognitiveactions.com/invocations/bfa6025f-c398-47ff-b02c-8b7d4e961778/c3e9394d-38f0-4549-b34b-de63f9e94b98.png",
  "https://assets.cognitiveactions.com/invocations/bfa6025f-c398-47ff-b02c-8b7d4e961778/9f492a59-dafb-43b2-9340-5f95698e6969.png"
]

Conceptual Usage Example (Python)

To execute the Generate Inpainted Image action, you can use the following Python code snippet:

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 = "8725bab9-2561-438c-921d-ba6920a6d883"  # Action ID for Generate Inpainted Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "width": 1020,
    "height": 1350,
    "prompt": "a photo of ROX, a woman with a nose piercing, wearing a black shirt and earrings, looking at the camera with a smirk on her face",
    "loraIntensity": 1,
    "numberOfOutputs": 2,
    "imageAspectRatio": "1:1",
    "guidanceIntensity": 3.5,
    "imageOutputFormat": "png",
    "inferenceStepCount": 35,
    "outputImageQuality": 100,
    "additionalLoraIntensity": 0.8
}

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 payload variable contains the input JSON required for the action. The example shows how to structure your request and handle the response effectively.

Conclusion

The Generate Inpainted Image action from the juddisjudd/roxannec Cognitive Actions provides an easy-to-use yet powerful tool for developers to create customized images based on text prompts. By leveraging this action, you can enhance your applications with high-quality image generation capabilities. Explore further use cases, such as integrating this functionality into web applications or creative design tools, to unlock the full potential of image processing in your projects. Happy coding!

← Back to All Articles