Transform Your Images with the BlendGAN Cognitive Actions

24 Apr 2025
Transform Your Images with the BlendGAN Cognitive Actions

The BlendGAN Cognitive Actions enable developers to generate unique, stylized facial images by blending facial and style representations. This powerful API leverages a flexible blending strategy to create high-fidelity and diverse stylizations, making it an exciting tool for applications in art, gaming, and more. In this guide, we will explore how to integrate the "Generate Stylized Face" action into your applications, providing you with the resources needed to get started.

Prerequisites

Before you begin using the BlendGAN Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform, which will be used for authentication.
  • Basic understanding of JSON and how to make HTTP requests.

Authentication is typically handled by passing the API key in the request headers.

Cognitive Actions Overview

Generate Stylized Face

Description: This action generates arbitrarily stylized facial images using BlendGAN. It allows you to blend a source facial image with a style reference image, resulting in a new image that combines elements from both.

Category: Image Generation

Input

The input for this action includes two required fields:

  • sourceImage: A URI that points to the source facial image (aligned and resized to 1024x1024 pixels).
  • styleReferenceImage: A URI that points to the style reference facial image (also aligned and resized to 1024x1024 pixels).

Example Input:

{
  "sourceImage": "https://replicate.delivery/mgxm/61081ee0-dd02-4538-a7d4-08986d44e13b/000000.png",
  "styleReferenceImage": "https://replicate.delivery/mgxm/1898cc8a-51b0-4627-b3cf-e68fdee307fa/100010.png"
}

Output

The action typically returns a URI that points to the generated stylized facial image.

Example Output:

https://assets.cognitiveactions.com/invocations/c9186977-c146-469c-8f55-ffdeca3f19c3/a755220f-b4f0-4135-8293-6060c2faec45.png

Conceptual Usage Example (Python)

Here is a conceptual Python code snippet demonstrating how to call the BlendGAN 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 = "59c8680e-ef35-4cf9-9c16-05d8b8299cd7" # Action ID for Generate Stylized Face

# Construct the input payload based on the action's requirements
payload = {
    "sourceImage": "https://replicate.delivery/mgxm/61081ee0-dd02-4538-a7d4-08986d44e13b/000000.png",
    "styleReferenceImage": "https://replicate.delivery/mgxm/1898cc8a-51b0-4627-b3cf-e68fdee307fa/100010.png"
}

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, you replace the placeholder for your API key and use the provided action ID. The input payload is structured as per the requirements for the "Generate Stylized Face" action.

Conclusion

The BlendGAN Cognitive Actions offer an innovative way to generate stylized images, making it an invaluable tool for developers looking to enhance their applications with unique visual content. By integrating the "Generate Stylized Face" action, you can easily create diverse facial images that blend different styles. As you explore this capability, consider additional use cases such as art generation, character design in games, or creating personalized avatars. Happy coding!

← Back to All Articles