Unlocking Image Generation with the igloobentwicket/vintage_signs Cognitive Actions

24 Apr 2025
Unlocking Image Generation with the igloobentwicket/vintage_signs Cognitive Actions

In the world of artificial intelligence and creative applications, the igloobentwicket/vintage_signs API offers a unique Cognitive Action that enables developers to generate high-quality images from textual prompts. This action utilizes advanced inpainting techniques, allowing for detailed customization and flexibility. With the ability to create stunning visuals, you can enhance your applications and provide users with captivating content.

Prerequisites

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

  • An API key for the Cognitive Actions platform. This key will be used to authenticate your requests.
  • Familiarity with making HTTP requests in your preferred programming language.

Authentication typically involves passing your API key in the headers of your requests, ensuring secure access to the Cognitive Actions service.

Cognitive Actions Overview

Generate Image Using Image Mask

Description: This action generates images from textual prompts using advanced inpainting modes with image masks. The action provides options to leverage different models (dev and schnell) to optimize the balance between speed and quality.

Category: Image Generation

Input: The input for this action requires a JSON object that includes the following fields:

  • prompt (string, required): The text prompt that describes the desired image. For example:
    "A dusty crossroad in the desert mountains, with weathered abandoned buildings and a an old VinSign vintage neon sign advertising a Motel prominently visible on the roadside in front of a dilapidated building"
  • mask (string, optional): URI of the image mask for inpainting mode.
  • seed (integer, optional): Seed for random number generation.
  • image (string, optional): URI of the input image for image-to-image or inpainting modes.
  • width (integer, optional): Width of the generated image.
  • height (integer, optional): Height of the generated image.
  • outputCount (integer, optional): Number of images to generate (1 to 4).
  • imageQuality (integer, optional): Quality of output images (0 to 100).
  • goFast (boolean, optional): Enable faster predictions.
  • inferenceModel (string, optional): Model for running inference (dev or schnell).
  • imageOutputFormat (string, optional): Format of the output images (e.g., webp, jpg, png).

Example Input:

{
  "width": 1024,
  "goFast": false,
  "height": 1024,
  "prompt": "A dusty crossroad in the desert mountains, with weathered abandoned buildings and a an old VinSign vintage neon sign advertising a Motel prominently visible on the roadside in front of a dilapidated building",
  "outputCount": 1,
  "imageQuality": 80,
  "loraIntensity": 1,
  "denoisingSteps": 28,
  "inferenceModel": "dev",
  "imageMegapixels": "1",
  "promptIntensity": 0.8,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "diffusionGuidanceScale": 3,
  "additionalLoraIntensity": 0.84
}

Output: The output is typically a JSON array containing the URLs of the generated images. For example:

[
  "https://assets.cognitiveactions.com/invocations/94291cb6-19b5-4ddd-b2e8-25dc1ba078fe/593ee3a4-4cd5-4ff4-a26b-9fef0e3c8012.webp"
]

Conceptual Usage Example (Python): Here’s how you might interact with this Cognitive 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 = "e4373952-d8fd-46bf-82fc-19bf9ddc2ead" # Action ID for Generate Image Using Image Mask

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "goFast": False,
    "height": 1024,
    "prompt": "A dusty crossroad in the desert mountains, with weathered abandoned buildings and a an old VinSign vintage neon sign advertising a Motel prominently visible on the roadside in front of a dilapidated building",
    "outputCount": 1,
    "imageQuality": 80,
    "loraIntensity": 1,
    "denoisingSteps": 28,
    "inferenceModel": "dev",
    "imageMegapixels": "1",
    "promptIntensity": 0.8,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "diffusionGuidanceScale": 3,
    "additionalLoraIntensity": 0.84
}

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 snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload structure is built according to the input schema, ensuring that all required fields are included. The endpoint URL and request structure are illustrative and should be adjusted based on your actual implementation.

Conclusion

The igloobentwicket/vintage_signs Cognitive Action opens the door to advanced image generation capabilities with minimal effort. By leveraging the ability to create images from textual descriptions, developers can enhance user experiences and create engaging content. Explore the possibilities of integrating this action into your applications and consider how you can utilize it for various use cases, from creative storytelling to marketing visuals.

← Back to All Articles