Elevate Your App's Creativity: Integrating Image Generation with Pagebrain Rev Animated Actions

24 Apr 2025
Elevate Your App's Creativity: Integrating Image Generation with Pagebrain Rev Animated Actions

In today's digital landscape, the ability to generate and manipulate images dynamically can significantly enhance user experiences. The Pagebrain Rev Animated V1.2.2 API provides powerful Cognitive Actions for developers looking to incorporate advanced image processing capabilities into their applications. Among these actions, the "Generate Image with Inpainting" action stands out for its versatility in transforming images and creating stunning visual content. In this article, we will explore how to effectively use this action in your projects.

Prerequisites

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

  • An API key for the Pagebrain Cognitive Actions platform.
  • A basic understanding of JSON and HTTP requests.
  • Familiarity with Python programming for implementing the provided code snippets.

For authentication, you will typically pass your API key in the headers of your requests, allowing you to securely access the Cognitive Actions functionalities.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action leverages the Rev Animated V1.2.2 model to create images through inpainting and img2img transformations. This action supports customizable features including prompt guidance, negative embeddings, and various scheduling algorithms, enabling developers to enhance image fidelity in high-definition resolution.

Input

The input for this action requires the following fields:

  • mask: URI of the input mask for inpainting. Black areas are preserved, while white areas are inpainted.
  • seed: (Optional) A random seed for reproducibility. If omitted, a random seed is used.
  • image: URI of the input image for img2img or inpainting mode.
  • width: Width of the output image in pixels. Valid options range from 128 to 1024 pixels.
  • height: Height of the output image in pixels. Valid options range from 128 to 1024 pixels.
  • prompt: A descriptive text input to guide the image generation model.
  • scheduler: Algorithm for determining the sequence of denoising steps. Default is 'K_EULER'.
  • guidanceScale: A scale factor to enhance adherence to the prompt (1 to 20).
  • excludedPrompt: Text or features to exclude from the output.
  • promptStrength: Influence strength of the original image against the prompt (0 to 1).
  • numberOfOutputs: Number of images to generate (1 to 4).
  • safetyCheckEnabled: Toggle for filtering unwanted content (default is true).
  • inferenceStepsCount: Total computational steps for denoising (1 to 500).

Example Input:

{
  "seed": 2937362614,
  "width": 576,
  "height": 1024,
  "prompt": "((best quality)), ((masterpiece)), (detailed), woman with green hair, holding a sword...",
  "scheduler": "KarrasDPM",
  "guidanceScale": 8.5,
  "excludedPrompt": "realisticvision-negative-embedding, EasyNegative...",
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "safetyCheckEnabled": false,
  "inferenceStepsCount": 30
}

Output

Upon successful execution, the action typically returns an array of image URLs corresponding to the generated outputs.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/a0b8a315-8f70-4d0f-9510-6964ced54d03/9d0a2a36-40c8-489a-bc4e-4dc095a53c36.png"
]

Conceptual Usage Example (Python)

Here's how you might invoke this action 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 = "67cca724-f427-43b3-919c-ab6b39b41cce"  # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "seed": 2937362614,
    "width": 576,
    "height": 1024,
    "prompt": "((best quality)), ((masterpiece)), (detailed), woman with green hair, holding a sword...",
    "scheduler": "KarrasDPM",
    "guidanceScale": 8.5,
    "excludedPrompt": "realisticvision-negative-embedding, EasyNegative...",
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "safetyCheckEnabled": false,
    "inferenceStepsCount": 30
}

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 example, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID and input payload are structured according to the specifications for the Generate Image with Inpainting action.

Conclusion

The Pagebrain Rev Animated V1.2.2 Cognitive Action for image generation and inpainting opens up a realm of creative possibilities for developers. By integrating this action, you can enhance your applications with dynamic and visually appealing content generation. Explore the various parameters to tailor the output to your needs and unlock the full potential of image processing in your projects. Whether you're building games, art applications, or visual storytelling platforms, this action can help you create striking imagery that captivates your audience. Happy coding!

← Back to All Articles