Elevate Your Image Editing with Multi-Stage Blended Diffusion Cognitive Actions

21 Apr 2025
Elevate Your Image Editing with Multi-Stage Blended Diffusion Cognitive Actions

In today's digital world, high-quality image editing has become essential for various applications, from content creation to design and marketing. The Multi-Stage Blended Diffusion set of Cognitive Actions, powered by stable-diffusion technology, provides developers with powerful tools to execute high-resolution image edits. This blog post will guide you through the capabilities of the Perform Multi-Stage Image Editing action, explaining how to seamlessly integrate it into your applications.

Prerequisites

Before you begin using the Multi-Stage Blended Diffusion Cognitive Actions, ensure you have the following:

  • An API key for accessing the Cognitive Actions platform.
  • Basic knowledge of JSON and HTTP requests.
  • A setup environment where you can make API calls (Python is used in the examples).

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

Cognitive Actions Overview

Perform Multi-Stage Image Editing

The Perform Multi-Stage Image Editing action allows you to execute high-resolution image editing by leveraging advanced techniques like multi-stage blended diffusion. This action enables targeted modifications to input images using a mask and a textual prompt, resulting in visually appealing edits tailored to your specifications.

  • Category: Image Editing

Input

To invoke this action, you need to construct a payload that adheres to the following schema:

{
  "inputMask": "string (uri)",
  "editPrompt": "string",
  "inputImage": "string (uri)",
  "marginMultiplier": "number (optional)"
}

Required Fields:

  • inputMask: A URI pointing to the mask image that specifies the area to be edited. This image highlights regions within the input image for modifications.
  • editPrompt: A textual prompt used to generate content within the specified editing area defined by the input mask.
  • inputImage: A URI of the image to be edited, serving as the base for applying the mask and executing the prompt-driven edits.

Optional Field:

  • marginMultiplier: A numeric value that determines the margin applied around the mask area for editing (default is 1.4).

Example Input:

Here’s an example of a JSON payload you would send to request the action:

{
  "inputMask": "https://replicate.delivery/pbxt/Hqop9sF95X7wEbOK0yAFcokC6GOsR8faCuHQ8yfFYz1nPqrw/bedroom_painting_mask.png",
  "editPrompt": "a painting is hanging on the wall",
  "inputImage": "https://replicate.delivery/pbxt/HqopAAYEyqpSmf1OP2cw3Dl8pcZI6IWXdp1sxnMy2KuRvh3K/bedroom_painting.jpg",
  "marginMultiplier": 1.4
}

Output

The action typically returns a URI pointing to the edited image. Here’s an example of the output you might receive:

https://assets.cognitiveactions.com/invocations/4ab40722-75b7-41bb-b631-d7de37fd34d6/de648195-aa35-44a1-9779-b67bfaaee040.png

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the Multi-Stage Image Editing action using a hypothetical 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 = "eec40916-c4e6-4dbe-98ab-fdb4322e794b" # Action ID for Perform Multi-Stage Image Editing

# Construct the input payload based on the action's requirements
payload = {
    "inputMask": "https://replicate.delivery/pbxt/Hqop9sF95X7wEbOK0yAFcokC6GOsR8faCuHQ8yfFYz1nPqrw/bedroom_painting_mask.png",
    "editPrompt": "a painting is hanging on the wall",
    "inputImage": "https://replicate.delivery/pbxt/HqopAAYEyqpSmf1OP2cw3Dl8pcZI6IWXdp1sxnMy2KuRvh3K/bedroom_painting.jpg",
    "marginMultiplier": 1.4
}

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 required input for the action.
  • The response is printed in a formatted manner for better readability.

Conclusion

The Perform Multi-Stage Image Editing action offers a robust solution for developers looking to enhance their applications with advanced image editing capabilities. By leveraging the power of Multi-Stage Blended Diffusion, you can create stunning visuals tailored to user specifications. Next steps could include exploring further integrations or experimenting with different prompts and masks to see the full potential of this action in your projects. Happy coding!

← Back to All Articles