Create Stunning Images with the xkevinemx/kevinem1 Cognitive Actions

24 Apr 2025
Create Stunning Images with the xkevinemx/kevinem1 Cognitive Actions

In today's fast-paced digital world, the ability to generate high-quality images quickly and efficiently is a game-changer for developers. The xkevinemx/kevinem1 specification offers a powerful Cognitive Action that enables you to create detailed images using advanced AI techniques. This action leverages inpainting and image-to-image capabilities, allowing you to customize various image attributes for your projects. By using these pre-built actions, you can focus on innovation while letting the AI handle the complexity of image generation.

Prerequisites

Before you begin integrating the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Access to an environment that can make HTTP requests (like Python’s requests library).

Conceptually, authentication is typically handled by passing your API key in the request headers. This ensures secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate AI Image

Description:
This action allows you to create detailed images using advanced AI inpainting and image-to-image techniques. You can customize attributes such as aspect ratio, width, height, and select models for precision or speed.

Category: Image Generation

Input

The input schema for this action requires the following fields:

  • prompt (required): A detailed description of the image you want to create.
  • mask (optional): An image mask for inpainting mode.
  • seed (optional): A random seed for reproducible generation.
  • image (optional): An input image for image-to-image or inpainting mode.
  • model (optional): Choose between "dev" (for detail) or "schnell" (for speed).
  • width and height (optional): Specify the dimensions; only used if using a custom aspect ratio.
  • aspectRatio (optional): Determines the aspect ratio (e.g., "1:1", "16:9").
  • outputCount (optional): Number of images to generate (1 to 4).
  • outputFormat (optional): Choose the output image format ("webp", "jpg", "png").
  • guidanceScale, loraIntensity, outputQuality, promptStrength, imageResolution, inferenceStepCount, and others (optional): Various parameters for fine-tuning the image generation.

Example Input:

{
  "model": "dev",
  "prompt": "Create a professional LinkedIn promotional image featuring Kevin at the center, smiling confidently and looking directly into the camera. The background should showcase a split-screen effect that represents the workshop's Canary Islands location and AI-powered focus:\n\nLeft Side: A dynamic depiction of innovation and AI tools. Include glowing circuit board patterns, futuristic icons (e.g., a robot 🤖, a data network icon 🌐), and abstract blue tones to convey a tech-savvy atmosphere.\n\nRight Side: A serene Canary Islands scene with soft warm lighting. Showcase golden beaches, palm trees 🌴, and a calm ocean, emphasizing the tranquil retreat vibe.\n\nOverlay Text:\n\nTop Line (Bold and Bright): \"AI-Powered Recruitment Workshop\"\nBottom Line (Subtext): \"Learn. Network. Transform in the Canary Islands 🌞🌴\"\nAdditional Details:\n\nUse clean, professional fonts that stand out, with the main text in white or bright tones against the contrasting background.\nAdd a subtle call-to-action at the bottom: \"Limited Spots Available – Reserve Yours Today!\"\nEnsure Kevin’s presence remains central to the design, blending professionalism with an approachable and aspirational vibe.",
  "fastMode": false,
  "aspectRatio": "1:1",
  "outputCount": 1,
  "outputFormat": "png",
  "guidanceScale": 3.01,
  "loraIntensity": 1,
  "outputQuality": 80,
  "promptStrength": 0.8,
  "imageResolution": "1",
  "inferenceStepCount": 28,
  "additionalLoraIntensity": 1
}

Output

The action typically returns a URL link to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/5916fed2-bbc5-429c-ba7c-ce52950a0bf1/6c94895e-c887-4dbf-bb6b-8d498bcb854f.png"
]

Conceptual Usage Example (Python)

Here's a conceptual Python code snippet showing how you might call this action via a hypothetical Cognitive Actions execution 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 = "e0cb202d-7352-4e32-825d-e7b678ef836c"  # Action ID for Generate AI Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "Create a professional LinkedIn promotional image featuring Kevin at the center, smiling confidently...",
    "fastMode": False,
    "aspectRatio": "1:1",
    "outputCount": 1,
    "outputFormat": "png",
    "guidanceScale": 3.01,
    "loraIntensity": 1,
    "outputQuality": 80,
    "promptStrength": 0.8,
    "imageResolution": "1",
    "inferenceStepCount": 28,
    "additionalLoraIntensity": 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 example, replace the placeholder API key and endpoint with your actual values. The payload variable contains the structured input needed to invoke the action, illustrating how to utilize the prompt and other parameters effectively.

Conclusion

The Generate AI Image action in the xkevinemx/kevinem1 specification provides an easy way to produce stunning visuals tailored to your specifications. By leveraging these Cognitive Actions, developers can enhance their applications with rich, engaging imagery without needing extensive graphics expertise. Consider exploring further use cases, such as integrating this action into content creation platforms or marketing tools, to fully harness its potential. Happy coding!

← Back to All Articles