Generate Stunning Images with fovkotov/pop Cognitive Actions

22 Apr 2025
Generate Stunning Images with fovkotov/pop Cognitive Actions

In the world of image generation, the fovkotov/pop Cognitive Actions provide powerful tools for developers looking to create and customize images programmatically. With the ability to utilize advanced models and parameters, these actions simplify the process of generating unique images based on specific prompts. This blog post will guide you through the capabilities of the "Generate Image with Mask" action and how to effectively incorporate it into your applications.

Prerequisites

To get started with the fovkotov/pop Cognitive Actions, you need to have an API key for the Cognitive Actions platform. This key will be used for authentication when making requests. Generally, authentication involves passing the API key in the headers of your HTTP requests.

Cognitive Actions Overview

Generate Image with Mask

The Generate Image with Mask action allows developers to create images using specified models (either 'dev' or 'schnell') with the option for inpainting mode. This action supports numerous parameters for customization, including image dimensions, aspect ratio, and random seed for reproducibility. Additionally, you can choose between fast generation for quicker outputs or the original format for higher quality.

Input

The input for this action requires the following fields:

  • prompt (required): A string that describes the image you want to generate (e.g., "rock in style of por").
  • model (optional): Specifies the model to use for generation, with options like "dev" or "schnell".
  • goFast (optional): A boolean that, when set to true, enables faster predictions.
  • width (optional): The width of the generated image (when using a custom aspect ratio).
  • height (optional): The height of the generated image (when using a custom aspect ratio).
  • seed (optional): An integer for setting a random seed for reproducible results.
  • numOutputs (optional): Number of images to generate (1 to 4).
  • guidanceScale (optional): A number (0 to 10) that helps define the artistic style and realism of the image.
  • outputQuality (optional): Specifies the quality of the output image (0 to 100).

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

{
  "model": "dev",
  "goFast": false,
  "prompt": "rock in style of por",
  "loraScale": 2.2,
  "numOutputs": 1,
  "guidanceScale": 3,
  "outputQuality": 80,
  "imageMegapixels": "1",
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28
}

Output

Upon successful execution, the action will return a URL pointing to the generated image. Here’s an example of the output:

[
  "https://assets.cognitiveactions.com/invocations/a7e83c5b-527e-42af-a143-327e7841d752/2ebdc28c-7d69-4976-a8e6-9dd4e55a19ba.webp"
]

Conceptual Usage Example (Python)

Here’s how you might call the Generate Image with Mask 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 = "d67853fd-8e08-48cb-be66-21b72dd325d1"  # Action ID for Generate Image with Mask

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "goFast": False,
    "prompt": "rock in style of por",
    "loraScale": 2.2,
    "numOutputs": 1,
    "guidanceScale": 3,
    "outputQuality": 80,
    "imageMegapixels": "1",
    "imageAspectRatio": "1:1",
    "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 the placeholder for COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID for "Generate Image with Mask" is included, and the input payload is structured based on the required fields.

Conclusion

The fovkotov/pop Cognitive Actions provide a robust framework for image generation, allowing developers to create tailored images based on creative prompts. With the ability to adjust various parameters, you can fine-tune the outputs to meet your specific needs. Whether you're building an art application, creating unique visuals for marketing, or experimenting with AI-generated art, these actions are an excellent addition to your development toolkit. Start integrating these actions today and unleash your creativity!

← Back to All Articles