Enhance Your App with Image Generation: A Guide to nicolesan22/nicoleasankowski Actions

22 Apr 2025
Enhance Your App with Image Generation: A Guide to nicolesan22/nicoleasankowski Actions

In today's digital landscape, the ability to generate and manipulate images programmatically is a powerful asset for any developer. The nicolesan22/nicoleasankowski API offers a set of Cognitive Actions designed to simplify the process of image generation, allowing you to create stunning visuals tailored to your specific requirements. One of the standout actions in this suite is the Generate Image With Mask, which enables developers to generate images using custom prompts and masks, providing flexibility in aspect ratios and output quality.

Prerequisites

To get started with the Cognitive Actions in the nicolesan22/nicoleasankowski API, you will need:

  • An API key for authentication purposes.
  • A basic understanding of making HTTP requests and handling JSON data.

Authentication typically involves passing your API key in the request headers to access the Cognitive Actions service.

Cognitive Actions Overview

Generate Image With Mask

The Generate Image With Mask action allows you to create images using a specified mask, enabling advanced features like image inpainting and transformation. This action supports different models for varying speed and quality, allowing developers to produce high-quality images tailored to their needs.

Input:

The input schema for this action requires a prompt and can include several optional fields:

{
  "goFast": false,
  "prompt": "portrait photo of nicoleasankowski smiling and looking confident and happy, sitting at a laptop, full frontal, slim and good posture",
  "loraScale": 1,
  "numOutputs": 1,
  "guidanceScale": 6.69,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "imageAspectRatio": "16:9",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28
}
  • Required Field:
    • prompt: A text prompt that guides the image generation process.
  • Optional Fields:
    • mask: URI for the image mask (if provided, width and height are ignored).
    • seed: Random seed for reproducibility.
    • image: Input image for image-to-image or inpainting mode (also ignores width and height).
    • width: Width of the generated image (only for custom aspect ratios).
    • height: Height of the generated image (only for custom aspect ratios).
    • goFast: Enables faster image generation.
    • numOutputs: Number of images to generate (1-4).
    • guidanceScale: Affects the quality of the generated image.
    • outputQuality: Quality of the output images (0-100).
    • imageAspectRatio: Defines the aspect ratio of the generated image.
    • imageOutputFormat: Format of the output images (webp, jpg, png).
    • Additional parameters like loraWeights, extraLora, and their corresponding scales for advanced customization.

Output:

The output of this action is a URL pointing to the generated image. For example:

[
  "https://assets.cognitiveactions.com/invocations/2347ad96-4d63-40d1-9ad0-49377d5be9e6/2e83d943-afd5-4007-9b10-75ef73d354a0.webp"
]

Conceptual Usage Example (Python):

To invoke the Generate Image With Mask action, you can use the following Python snippet:

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 = "8e3037ca-e941-45b5-b849-321eecf0fc40"  # Action ID for Generate Image With Mask

# Construct the input payload based on the action's requirements
payload = {
    "goFast": False,
    "prompt": "portrait photo of nicoleasankowski smiling and looking confident and happy, sitting at a laptop, full frontal, slim and good posture",
    "loraScale": 1,
    "numOutputs": 1,
    "guidanceScale": 6.69,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "imageMegapixels": "1",
    "imageAspectRatio": "16:9",
    "imageOutputFormat": "webp",
    "numInferenceSteps": 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 provided payload structure aligns with the requirements of the Generate Image With Mask action, ensuring you can generate images as specified.

Conclusion

The nicolesan22/nicoleasankowski API provides powerful Cognitive Actions that can significantly enhance your application’s capabilities. The Generate Image With Mask action, with its flexibility and customization options, is a valuable tool for developers looking to integrate advanced image generation features. Explore these actions further to unlock new creative possibilities in your applications.

← Back to All Articles