Create Stunning Images with the juannba/paradisef Cognitive Actions

23 Apr 2025
Create Stunning Images with the juannba/paradisef Cognitive Actions

In the world of AI-driven creativity, the juannba/paradisef API offers powerful Cognitive Actions tailored for image generation. Among these, the Generate Image with Inpainting action stands out, enabling developers to create visually appealing images with custom parameters. This article will guide you through the capabilities of this action, its input and output structures, and provide a conceptual example to help you integrate it into your applications.

Prerequisites

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

  • An API key for the juannba/paradisef platform to authenticate your requests.
  • Basic understanding of making HTTP requests in your preferred programming language.

Authentication typically involves passing your API key in the request headers, ensuring that your actions are properly authorized.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action allows you to create an inpainted image by utilizing a range of customizable parameters such as image masks, resolution, and artistic styles. This action is categorized under image-generation and is optimized for both speed and quality, making it an excellent choice for developers looking to produce high-quality visual content.

Input

The action requires a specific JSON structure for input. Here’s a breakdown of the required and optional fields based on the input schema:

  • Required:
    • prompt (string): A descriptive text that guides the image generation.
  • Optional:
    • mask (string): URI for the image mask used in inpainting.
    • seed (integer): Random seed for reproducibility.
    • image (string): URI for the input image.
    • imageWidth (integer): Width of the generated image (256 to 1440 pixels).
    • imageHeight (integer): Height of the generated image (256 to 1440 pixels).
    • modelWeights (string): Load LoRA weights from specified sources.
    • mainLoraScale (number): Strength of main LoRA application (default: 1).
    • denoisingSteps (integer): Number of steps for denoising (default: 28).
    • enableFastMode (boolean): Use optimized, faster predictions (default: false).
    • inferenceModel (string): Selects the inference model (default: "dev").
    • numberOfOutputs (integer): Number of output images (default: 1).
    • imageAspectRatio (string): Aspect ratio for the image (default: "1:1").
    • guidanceIntensity (number): Guidance scale for the diffusion process (default: 3).
    • imageOutputFormat (string): Format for saved images (default: "webp").
    • imageOutputQuality (integer): Quality level for saved outputs (default: 80).
    • Additional parameters for advanced configurations.

Here's an example of the JSON payload needed to invoke the action:

{
  "prompt": "silk eye mask tok ,A luxurious bedroom inside a grand mansion with elegant decor. A young woman is lying on a lavish king-size bed with silky sheets and soft pillows. She wears a light pink silk eye mask tok  embroidered with the word 'PARADISE' in delicate gold thread. The atmosphere exudes sophistication and exclusivity, with warm ambient lighting, a chandelier above, and subtle golden accents in the decor. The image should evoke a sense of ultimate luxury and comfort.\n\n",
  "mainLoraScale": 1,
  "denoisingSteps": 28,
  "enableFastMode": false,
  "inferenceModel": "dev",
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 3,
  "imageOutputFormat": "webp",
  "imageOutputQuality": 80,
  "additionalLoraScale": 1,
  "imagePromptStrength": 0.8,
  "imageSizeInMegapixels": "1"
}

Output

Upon successful execution, the action returns a list of generated image URLs. Here's an example of a typical response:

[
  "https://assets.cognitiveactions.com/invocations/5d3657c0-1ab9-475e-926b-56be194deba9/95c172b1-9d23-464f-bc05-d84c36013384.webp"
]

This URL points to the generated image, which can be directly used in your applications.

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet illustrating how to call the Generate Image with Inpainting action using a hypothetical Cognitive Actions endpoint:

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 = "af4d5e3e-30cb-4932-94d7-3267c128558d" # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
  "prompt": "silk eye mask tok ,A luxurious bedroom inside a grand mansion with elegant decor. A young woman is lying on a lavish king-size bed with silky sheets and soft pillows. She wears a light pink silk eye mask tok  embroidered with the word 'PARADISE' in delicate gold thread. The atmosphere exudes sophistication and exclusivity, with warm ambient lighting, a chandelier above, and subtle golden accents in the decor. The image should evoke a sense of ultimate luxury and comfort.\n\n",
  "mainLoraScale": 1,
  "denoisingSteps": 28,
  "enableFastMode": false,
  "inferenceModel": "dev",
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 3,
  "imageOutputFormat": "webp",
  "imageOutputQuality": 80,
  "additionalLoraScale": 1,
  "imagePromptStrength": 0.8,
  "imageSizeInMegapixels": "1"
}

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 the YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID af4d5e3e-30cb-4932-94d7-3267c128558d is used to specify the action you want to execute.

Conclusion

The Generate Image with Inpainting action from the juannba/paradisef API is a robust tool for developers looking to create high-quality images tailored to specific requirements. By leveraging its customizable input parameters, you can generate visually stunning content that meets your application's needs. Explore further use cases, experiment with different parameters, and integrate this powerful action into your projects to elevate your creative capabilities!

← Back to All Articles