Generate Stunning Images with the karlvann/pauline_close Cognitive Actions

23 Apr 2025
Generate Stunning Images with the karlvann/pauline_close Cognitive Actions

In the realm of image generation, the karlvann/pauline_close API offers a powerful Cognitive Action that allows developers to create images from text prompts using advanced inpainting techniques. By leveraging the capabilities of this action, you can produce unique and customized visuals tailored to your specifications. Whether you're building an art application, enhancing content creation tools, or experimenting with AI-generated art, this action provides a robust solution.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • A basic understanding of JSON format and HTTP requests.
  • Familiarity with Python programming, particularly using libraries such as requests.

Authentication typically involves passing your API key in the request headers to access these powerful functionalities securely.

Cognitive Actions Overview

Generate Image with Inpainting

  • Description: Utilize inpainting mode to generate an image from a text prompt with various customization options like mask URI, image dimensions, guidance scale, and formats. Supports different models including 'dev' for longer inference and 'schnell' for rapid generation.
  • Category: Image Generation

Input

The Generate Image with Inpainting action requires the following input fields:

  • prompt (required): A detailed text prompt to guide the image generation.
  • mask (optional): URI for the image mask used in inpainting mode.
  • seed (optional): Integer seed for random number generation to ensure reproducibility.
  • model (optional): Select the inference model, with options like 'dev' and 'schnell'.
  • width (optional): Width of the generated image in pixels.
  • height (optional): Height of the generated image in pixels.
  • outputCount (optional): Number of images to generate (1 to 4).
  • imageAspectRatio (optional): Sets the aspect ratio of the generated image.
  • imageOutputFormat (optional): File format for output images (e.g., webp, jpg, png).
  • imageOutputQuality (optional): Quality of the output image (0 to 100).
  • additional parameters: Such as LoRA intensity, denoising steps, and others.

Example Input:

{
  "seed": 60238,
  "model": "dev",
  "prompt": "A photo of a model with long blonde hair and a pink onesie sitting on a grey mattress with black sides. The room is nature themed and evokes a sense of spaciousness. The model is relaxed and glowing with happiness.",
  "outputCount": 4,
  "loraIntensity": 1,
  "additionalLora": "karlvann/earth38",
  "denoisingSteps": 28,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "imageOutputQuality": 90,
  "imagePromptIntensity": 0.8,
  "diffusionGuidanceScale": 3.5,
  "additionalLoraIntensity": 0.1
}

Output

Upon successful execution, the action returns an array of URLs pointing to the generated images. Each URL links to an image created based on the provided prompt and parameters.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/27ce4bb2-0fb8-4d4c-a733-c8c7c6aefd87/7500520d-b56c-4113-9d64-2ab3a7549ff0.webp",
  "https://assets.cognitiveactions.com/invocations/27ce4bb2-0fb8-4d4c-a733-c8c7c6aefd87/cbc18b14-7625-402a-8650-a79f677bd7de.webp",
  "https://assets.cognitiveactions.com/invocations/27ce4bb2-0fb8-4d4c-a733-c8c7c6aefd87/15dc428b-18e8-4090-a4f8-65ae0d12983e.webp",
  "https://assets.cognitiveactions.com/invocations/27ce4bb2-0fb8-4d4c-a733-c8c7c6aefd87/bda91723-6a0d-4321-a271-d3014328abc4.webp"
]

Conceptual Usage Example (Python)

Here’s a conceptual example of how you might use this action in 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 = "632f505c-4b2a-4029-830d-1d6f438d75a2"  # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "seed": 60238,
    "model": "dev",
    "prompt": "A photo of a model with long blonde hair and a pink onesie sitting on a grey mattress.",
    "outputCount": 4,
    "loraIntensity": 1,
    "additionalLora": "karlvann/earth38",
    "denoisingSteps": 28,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "imageOutputQuality": 90,
    "imagePromptIntensity": 0.8,
    "diffusionGuidanceScale": 3.5,
    "additionalLoraIntensity": 0.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 code, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable is structured according to the input schema of the action, and the response will provide you with the URLs of the generated images.

Conclusion

The Generate Image with Inpainting action from the karlvann/pauline_close API empowers developers to create intricate images from text prompts effortlessly. By utilizing its extensive customization options, you can tailor the output to meet your application's specific needs. Start experimenting with this action today and unlock the creative potential of AI-driven image generation!

← Back to All Articles