Generate Stunning Custom Images with the itsonelife/shakeelpictures Cognitive Actions

24 Apr 2025
Generate Stunning Custom Images with the itsonelife/shakeelpictures Cognitive Actions

In the ever-evolving world of digital content creation, the ability to generate customized visuals is a game-changer. The itsonelife/shakeelpictures API offers powerful Cognitive Actions that enable developers to create stunning images tailored to their specifications. With its advanced features like image-to-image conversion and inpainting, this API allows for versatile and high-quality image generation, making it an ideal choice for applications in various fields such as marketing, gaming, and more.

Prerequisites

Before you dive into the integration of Cognitive Actions for image generation, ensure you have the following prerequisites:

  • An API key for accessing the Cognitive Actions platform.
  • Basic understanding of JSON and HTTP requests.
  • Familiarity with Python programming for the conceptual code examples.

To authenticate your requests, you will typically pass your API key in the headers of your HTTP requests.

Cognitive Actions Overview

Generate Custom Image

The Generate Custom Image action is designed to create customized images based on a range of settings and input properties. This action provides flexibility through various options, including different models, aspect ratios, and output formats.

Input

The input schema for this action requires a prompt and may include optional parameters such as mask, image, model, and others. Here’s a breakdown of the required and optional fields:

  • prompt (required): A string that describes the image to be generated. For example, "SHAKEEL wearing a light blue shirt and a dark blue tie".
  • mask (optional): A URI string for an image mask used in inpainting mode.
  • image (optional): A URI string for an input image used in image-to-image or inpainting mode.
  • model (optional): Specifies the model used for inference, with options like "dev" (default) and "schnell".
  • width and height (optional): Integers defining the dimensions of the generated image.
  • aspectRatio (optional): Defines the aspect ratio, with options like "1:1", "4:5", and "custom".
  • megapixels (optional): Approximate number of megapixels for the generated image.
  • outputFormat (optional): Specifies the file format for the output image (e.g., "png").
  • numberOfOutputs (optional): Number of images to generate (default is 1).
Example Input
{
  "model": "dev",
  "prompt": "SHAKEEL wearing a light blue shirt and a dark blue tie ",
  "megapixels": "1",
  "aspectRatio": "4:5",
  "controlScale": 3,
  "outputFormat": "png",
  "mainLoraScale": 1,
  "outputQuality": 80,
  "enableFastMode": false,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "additionalLoraScale": 1,
  "numberOfInferenceSteps": 28
}

Output

The output from this action typically includes a URL to the generated image. For example:

[
  "https://assets.cognitiveactions.com/invocations/51b37581-b5b3-4c96-96c6-cb0dc7fd063e/d27ba52f-961d-44d9-8320-52d57cee64be.png"
]

Conceptual Usage Example (Python)

Here’s how you can invoke the Generate Custom 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 = "16c61fef-81ae-46ec-95b9-d7cb0cf9824f" # Action ID for Generate Custom Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "SHAKEEL wearing a light blue shirt and a dark blue tie ",
    "megapixels": "1",
    "aspectRatio": "4:5",
    "controlScale": 3,
    "outputFormat": "png",
    "mainLoraScale": 1,
    "outputQuality": 80,
    "enableFastMode": False,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "additionalLoraScale": 1,
    "numberOfInferenceSteps": 28
}

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 corresponds to the Generate Custom Image action, and the payload is structured according to the input schema.

Conclusion

The itsonelife/shakeelpictures Cognitive Actions empower developers to create custom images with ease. With a variety of options for customization, you can tailor your image generation to fit your specific needs, enhancing your applications with striking visuals. Whether you're looking to generate marketing materials, enhance gaming graphics, or create unique artworks, integrating this API opens up a world of creative possibilities. Start experimenting with these Cognitive Actions today and elevate your projects to new heights!

← Back to All Articles