Transform Your Images with HyperpotatoesX Mengov2: A Developer's Guide to Cognitive Actions

24 Apr 2025
Transform Your Images with HyperpotatoesX Mengov2: A Developer's Guide to Cognitive Actions

In today's digital landscape, the ability to generate and manipulate images programmatically opens up a wealth of creative possibilities. The HyperpotatoesX Mengov2 API provides developers with powerful Cognitive Actions that facilitate advanced image generation and inpainting. With these pre-built actions, you can easily integrate sophisticated image manipulation capabilities into your applications, enhancing user experiences and workflows.

Prerequisites

To get started with the HyperpotatoesX Mengov2 Cognitive Actions, you'll need to have a valid API key from the Cognitive Actions platform. The API key is typically passed in the headers of your requests to authenticate your application. Make sure to keep your API key secure and do not expose it in public repositories.

Cognitive Actions Overview

Generate Image with Inpainting

The Generate Image with Inpainting action allows you to create images using advanced inpainting techniques. By providing an initial image along with optional parameters, you can customize various properties such as aspect ratio, dimensions, output quality, and more. This action supports both standard and fast generation modes, as well as LoRA model integrations to enhance the quality of your images.

Input

The input for this action requires a prompt (string) to guide the image generation. Several optional fields allow for further customization:

  • mask (string): URI of the image mask used for inpainting mode. If specified, aspect ratio, width, and height are disregarded.
  • seed (integer): Initializes random generation; consistent seed values produce identical results.
  • image (string): URI of the input image for transformation or inpainting. Overrides aspect ratio, width, and height if specified.
  • model (string): Choose between "dev" (best performance) or "schnell" (fast mode).
  • width (integer): Width of the generated image in pixels (must be a multiple of 16).
  • height (integer): Height of the generated image in pixels (must be a multiple of 16).
  • goFast (boolean): Enable accelerated predictions.
  • imageFormat (string): Specify output format (webp, jpg, png).
  • outputCount (integer): Number of images to generate (1 to 4).
  • imageQuality (integer): Quality of output images (0 to 100).
  • additional parameters: Include various settings for LoRA models, guidance intensity, and more.
Example Input
{
  "model": "dev",
  "prompt": "a Mengo Yokoyari style image of Ai Hoshino a vibrant and colorful anime character with long, flowing purple hair...",
  "imageFormat": "webp",
  "outputCount": 4,
  "imageQuality": 90,
  "mainLoraScale": 1,
  "directionScale": 3.5,
  "inferenceSteps": 35,
  "promptIntensity": 0.8,
  "imageAspectRatio": "4:3",
  "additionalLoraScale": 1
}

Output

The action returns an array of URLs pointing to the generated images. Each URL corresponds to an image produced based on the input parameters.

Example Output
[
  "https://assets.cognitiveactions.com/invocations/44d0a6cc-f622-4a58-ac68-e8869503ff3c/4ea57320-57fa-4b93-9e5e-4d644d06420b.webp",
  "https://assets.cognitiveactions.com/invocations/44d0a6cc-f622-4a58-ac68-e8869503ff3c/cac5131c-6758-46f3-bbf3-7ddb59aa4871.webp",
  "https://assets.cognitiveactions.com/invocations/44d0a6cc-f622-4a58-ac68-e8869503ff3c/268ae5ab-d46d-4b5f-a4a0-5d4d1c1d0060.webp",
  "https://assets.cognitiveactions.com/invocations/44d0a6cc-f622-4a58-ac68-e8869503ff3c/6304bbb9-1c1b-4b8e-9bd1-d5498099554d.webp"
]

Conceptual Usage Example (Python)

Here's how you might call the Generate Image with Inpainting 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 = "08ce5a01-c196-44ce-b9d6-5abefdcfa87b" # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "a Mengo Yokoyari style image of Ai Hoshino a vibrant and colorful anime character with long, flowing purple hair...",
    "imageFormat": "webp",
    "outputCount": 4,
    "imageQuality": 90,
    "mainLoraScale": 1,
    "directionScale": 3.5,
    "inferenceSteps": 35,
    "promptIntensity": 0.8,
    "imageAspectRatio": "4:3",
    "additionalLoraScale": 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 snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload contains the input parameters for the action. The response will include URLs to the generated images.

Conclusion

The HyperpotatoesX Mengov2 Cognitive Actions provide powerful tools for developers looking to enhance their applications with advanced image generation capabilities. By leveraging the Generate Image with Inpainting action, you can create unique and customized images that meet your project's needs. Explore how these actions can transform your app and consider experimenting with different parameters to achieve the desired results. Happy coding!

← Back to All Articles