Create Stunning Polaroid Style Images with aramintak/pola-style Cognitive Actions

24 Apr 2025
Create Stunning Polaroid Style Images with aramintak/pola-style Cognitive Actions

The aramintak/pola-style spec introduces a powerful Cognitive Action designed for developers aiming to integrate image generation capabilities into their applications. The key action, Generate Polaroid Style Image, allows users to create realistic images in popular instant photo styles, such as Polaroid, using open-source materials. This action is particularly useful for those looking to enhance their projects with unique imagery reminiscent of classic instant photography.

Prerequisites

To start using the Cognitive Actions, you will need an API key from the Cognitive Actions platform. Once you have the key, authentication typically involves including it in the headers of your requests. This ensures that your application can securely access the Cognitive Actions services.

Cognitive Actions Overview

Generate Polaroid Style Image

The Generate Polaroid Style Image action creates images that mimic the nostalgic and recognizable Polaroid aesthetic. This action utilizes a combination of text prompts and various parameters to generate visually appealing images.

Input

The input schema for this action requires a JSON object with various parameters. Below are the key components:

  • prompt (required): A text prompt guiding the image generation, e.g., "a girl laughing, polaroid style".
  • model (optional): Choose between "dev" and "schnell" for inference model selection (default is "dev").
  • aspectRatio (optional): Defines the aspect ratio of the image (default is "1:1").
  • numOutputs (optional): Specifies the number of images to generate (default is 1).
  • outputFormat (optional): Format of the output images (default is "webp").
  • guidanceScale (optional): Adjusts the influence of the prompt during generation (default is 3).
  • outputQuality (optional): Quality of the generated image, ranging from 0 to 100 (default is 80).

Here’s an example input payload for this action:

{
  "model": "dev",
  "prompt": "a girl laughing, polaroid style",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 28
}

Output

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

[
  "https://assets.cognitiveactions.com/invocations/686dfff8-7107-4e39-83d2-41d8a4bd5df4/d41196e2-d64d-4e01-975b-ab376e720e7e.webp"
]

Conceptual Usage Example (Python)

Below is a conceptual Python snippet demonstrating how to call the Generate Polaroid Style Image action:

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 = "44c52d0a-dcac-48ba-93f3-d024270ad7f0"  # Action ID for Generate Polaroid Style Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "a girl laughing, polaroid style",
    "loraScale": 1,
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "guidanceScale": 3.5,
    "outputQuality": 90,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "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 snippet, replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The action ID should be set to the specific ID provided for generating Polaroid style images. The payload is structured to fit the requirements of the action.

Conclusion

The Generate Polaroid Style Image action from the aramintak/pola-style spec offers a straightforward way to produce beautiful, nostalgic images for your applications. By leveraging the power of this cognitive action, you can enhance your projects with unique visual content that resonates with users. Consider exploring various prompts and settings to fully utilize the capabilities of this action and create stunning imagery!

← Back to All Articles