Enhance Your Applications with Image Generation Using Falahgs/Angelina Jolie Actions

24 Apr 2025
Enhance Your Applications with Image Generation Using Falahgs/Angelina Jolie Actions

Integrating cognitive capabilities into your applications can dramatically enhance user experience, especially when it comes to visual content creation. The falahgs/angelina_jolie spec provides a powerful Cognitive Action known as Generate Image with Inpainting, enabling developers to create customized images through an intuitive API. This action allows for detailed customization based on user input, making it a valuable tool for various applications in the creative field.

Prerequisites

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

  • An API key for accessing the Cognitive Actions platform.
  • Familiarity with JSON and basic REST API concepts, as you'll be sending and receiving JSON payloads.

Authentication typically involves passing your API key in the request headers, allowing you to securely access the Cognitive Actions services.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action allows users to create images using a sophisticated inpainting model. This action supports custom prompts, image-to-image transformations, and offers fast generation options, allowing for highly customizable and detailed image outputs.

Input

The action requires a JSON payload containing various fields. Here’s a breakdown of the input schema:

  • prompt (required): The textual description for the image you want to generate.
  • model (optional): Choose between "dev" for detailed images or "schnell" for fast generation.
  • width (optional): Width of the generated image (when aspect_ratio is set to 'custom').
  • height (optional): Height of the generated image (when aspect_ratio is set to 'custom').
  • aspectRatio (optional): Defines the image's aspect ratio, defaulting to "1:1".
  • numOutputs (optional): Number of image outputs to generate, ranging from 1 to 4.
  • Additional parameters include guidanceScale, outputQuality, seed, and more for detailed customization.

Here is an example JSON input for this action:

{
  "model": "dev",
  "prompt": "a beautiful female playing a piano in garden",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 28
}

Output

The action returns a list of URLs pointing to the generated images. For example:

[
  "https://assets.cognitiveactions.com/invocations/2a5c9bcb-41d3-4e01-ab60-aa066e6bf2b4/dae0dd1a-431e-48ee-86ba-8fe5d275569f.webp"
]

This URL can be used to display or download the generated image.

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to invoke 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 = "6f9bbcb8-51f0-416a-85c8-ce63e4738a69" # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "a beautiful female playing a piano in garden",
    "loraScale": 1,
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "guidanceScale": 3.5,
    "outputQuality": 90,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "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 snippet, replace the placeholder API key and endpoint with your actual credentials. The input payload is structured according to the action's schema. The response will provide the generated image URLs.

Conclusion

The Generate Image with Inpainting action from the falahgs/angelina_jolie spec offers a powerful way to leverage image generation capabilities in your applications. By using customizable prompts and various options for image output, developers can create unique and engaging visual content tailored to their needs. Explore these capabilities and consider how they can enhance your projects and user experiences!

← Back to All Articles