Generate Stunning Images with the mcai Edge of Realism v2.0 Cognitive Actions

23 Apr 2025
Generate Stunning Images with the mcai Edge of Realism v2.0 Cognitive Actions

In today’s digital landscape, enhancing images and creating unique artistic renditions is more accessible than ever, thanks to powerful APIs like the mcai Edge of Realism v2.0. This suite of Cognitive Actions focuses on generating artistically refined image variations, allowing developers to leverage advanced algorithms for image enhancement. By integrating these pre-built actions into your applications, you can automate creative workflows, enhance user experiences, and produce high-quality visuals effortlessly.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of making HTTP requests and handling JSON data.
  • Familiarity with Python, as we will provide conceptual examples in this language.

Authentication typically involves passing your API key in the request headers, ensuring secure access to the actions.

Cognitive Actions Overview

Generate Realistic Image Variation

The "Generate Realistic Image Variation" action allows users to create a new, artistically enhanced image based on an input image. By utilizing the Edge Of Realism - EOR v2.0, this action enhances both the realism and artistic quality of the generated image.

  • Category: image-generation

Input

This action requires a JSON object with the following schema:

{
  "initialImageUri": "string (required)",
  "prompt": "string (optional)",
  "noiseStrength": "number (optional)",
  "schedulerType": "string (optional)",
  "upscaleFactor": "number (optional)",
  "outputImageCount": "integer (optional)",
  "inferenceStepCount": "integer (optional)",
  "guidanceScaleFactor": "number (optional)",
  "excludedElementsPrompt": "string (optional)"
}

Example Input:

{
  "prompt": "full body portrait of beautiful happy young ana de armas, ethereal, realistic anime, trending on pixiv, detailed, clean lines, sharp lines, crisp lines, award winning illustration, masterpiece, 4k, eugene de blaas and ross tran, vibrant color scheme, intricately detailed",
  "noiseStrength": 0.5,
  "schedulerType": "EulerAncestralDiscrete",
  "upscaleFactor": 1,
  "initialImageUri": "https://replicate.delivery/pbxt/IrB7vBOPZvm9t3GRknxkG3cp52SsACwkB0uAClkY7HApxRJ2/Tidbit_full_body_portrait_of_beautiful_happy_young_ana_de_armas_504a7edc-7e10-41a7-a414-f29fc34a3d44%20%281%29.png",
  "outputImageCount": 1,
  "inferenceStepCount": 30,
  "guidanceScaleFactor": 7.5,
  "excludedElementsPrompt": "disfigured, kitsch, ugly, oversaturated, greain, low-res, Deformed, blurry, bad anatomy, disfigured, poorly drawn face, mutation, mutated, extra limb, ugly, poorly drawn hands, missing limb, blurry, floating limbs, disconnected limbs, malformed hands, blur, out of focus, long neck, long body, ugly, disgusting, poorly drawn, childish, mutilated, mangled, old, surreal, calligraphy, sign, writing, watermark, text, body out of frame, extra legs, extra arms, extra feet, out of frame, poorly drawn feet, cross-eye, blurry, bad anatomy"
}

Output

The action typically returns a list of URLs pointing to the generated images.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/71d5312e-a13a-4701-bbb8-532b7c59e044/b647c3f6-670a-4a69-ba5e-b5712c2f0384.png"
]

Conceptual Usage Example (Python)

Here is a conceptual Python code snippet that demonstrates how you might call the Cognitive Actions execution endpoint for this 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 = "50fb3b3e-6e12-42a1-8157-21f269d931f1"  # Action ID for Generate Realistic Image Variation

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "full body portrait of beautiful happy young ana de armas, ethereal, realistic anime, trending on pixiv, detailed, clean lines, sharp lines, crisp lines, award winning illustration, masterpiece, 4k, eugene de blaas and ross tran, vibrant color scheme, intricately detailed",
    "noiseStrength": 0.5,
    "schedulerType": "EulerAncestralDiscrete",
    "upscaleFactor": 1,
    "initialImageUri": "https://replicate.delivery/pbxt/IrB7vBOPZvm9t3GRknxkG3cp52SsACwkB0uAClkY7HApxRJ2/Tidbit_full_body_portrait_of_beautiful_happy_young_ana_de_armas_504a7edc-7e10-41a7-a414-f29fc34a3d44%20%281%29.png",
    "outputImageCount": 1,
    "inferenceStepCount": 30,
    "guidanceScaleFactor": 7.5,
    "excludedElementsPrompt": "disfigured, kitsch, ugly, oversaturated, greain, low-res, Deformed, blurry, bad anatomy, disfigured, poorly drawn face, mutation, mutated, extra limb, ugly, poorly drawn hands, missing limb, blurry, floating limbs, disconnected limbs, malformed hands, blur, out of focus, long neck, long body, ugly, disgusting, poorly drawn, childish, mutilated, mangled, old, surreal, calligraphy, sign, writing, watermark, text, body out of frame, extra legs, extra arms, extra feet, out of frame, poorly drawn feet, cross-eye, blurry, bad anatomy"
}

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 action ID and input payload are structured to conform to the action's requirements, and the endpoint URL is illustrative.

Conclusion

The mcai Edge of Realism v2.0 Cognitive Actions empower developers to create stunning, high-quality images with minimal effort. By leveraging the "Generate Realistic Image Variation" action, you can enhance your applications with advanced image generation capabilities, making your projects stand out. Next steps might include exploring additional features of the API or integrating this action into a larger workflow for automated content creation. Happy coding!

← Back to All Articles