Create Stunning Images with the hyperpotatoesx/mengoyokoyari Cognitive Action

22 Apr 2025
Create Stunning Images with the hyperpotatoesx/mengoyokoyari Cognitive Action

In the rapidly evolving world of image generation, the hyperpotatoesx/mengoyokoyari API offers powerful Cognitive Actions that enable developers to create compelling and customized images. This API focuses on inpainting and image generation, providing a rich set of features that enhance creative workflows. By leveraging these pre-built actions, developers can streamline the image creation process, allowing for greater flexibility and artistic expression.

Prerequisites

To get started with the hyperpotatoesx/mengoyokoyari Cognitive Actions, you will need an API key for authentication. This key should be passed in the headers of your requests to ensure secure access to the service. Familiarity with JSON payloads and basic API interaction will be beneficial as you integrate these actions into your applications.

Cognitive Actions Overview

Generate Inpainting Image

The Generate Inpainting Image action is designed to create images using inpainting mode, enabling developers to customize various aspects of the image generation process. This includes options like prompt strength, mask, dimensions, and model selection, along with support for fast image generation.

  • Category: image-generation
  • Purpose: Generate an image while allowing fine-tuned customization for artistic control.

Input

The input payload for this action requires the following fields:

  • prompt (required): A text description that guides the image generation.
  • mask (optional): URI to the image mask used in inpainting mode.
  • seed (optional): Integer seed for reproducibility.
  • width (optional): Width in pixels (256-1440).
  • height (optional): Height in pixels (256-1440).
  • goFast (optional): Boolean to enable fast generation.
  • inputImage (optional): URI to an input image for processing.
  • guidanceScale (optional): Controls the influence of the prompt (0-10).
  • numberOfOutputs (optional): Number of images to generate (1-4).

Here’s an example of a JSON payload for this action:

{
  "prompt": "a Mengo Yokoyari style image of a lively character with short, vibrant red hair...",
  "loraScale": 1,
  "guidanceScale": 3.5,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "numberOfOutputs": 4,
  "imageAspectRatio": "4:3",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 35
}

Output

Upon successfully executing this action, the API will return an array of image URLs in the specified output format. Here’s an example of the expected output:

[
  "https://assets.cognitiveactions.com/invocations/1c24a598-7f51-4a30-a48c-00e24049babb/31d13a8e-77c3-4fd2-8e04-0aa8403c28d6.webp",
  "https://assets.cognitiveactions.com/invocations/1c24a598-7f51-4a30-a48c-00e24049babb/d6d92887-a16d-4f4f-9e40-42d2481ebf57.webp",
  "https://assets.cognitiveactions.com/invocations/1c24a598-7f51-4a30-a48c-00e24049babb/1709b27e-a60a-47e1-b629-f3dd58cb1100.webp",
  "https://assets.cognitiveactions.com/invocations/1c24a598-7f51-4a30-a48c-00e24049babb/f072bcc6-b6c1-424d-a761-5ddd10a56119.webp"
]

Conceptual Usage Example (Python)

Here’s how you might call the Generate Inpainting Image 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 = "ad795f76-7df2-40d5-8f63-ab44f92cac7e"  # Action ID for Generate Inpainting Image

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "a Mengo Yokoyari style image of a lively character with short, vibrant red hair...",
    "loraScale": 1,
    "guidanceScale": 3.5,
    "outputQuality": 90,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "numberOfOutputs": 4,
    "imageAspectRatio": "4:3",
    "imageOutputFormat": "webp",
    "numInferenceSteps": 35
}

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 code demonstrates how to prepare the input payload and handle the response effectively.

Conclusion

The hyperpotatoesx/mengoyokoyari Cognitive Actions provide developers with an innovative way to generate and customize images through advanced inpainting capabilities. By utilizing these actions, you can enhance your applications with stunning visuals tailored to your specifications. Whether you're creating art, designing characters, or exploring creative ideas, these tools can significantly streamline your workflow. As a next step, consider experimenting with different prompts and settings to discover the full potential of this powerful API!

← Back to All Articles