Enhance Your Applications with Kayaeh/Pau-Flux: A Developer's Guide to Image Generation

25 Apr 2025
Enhance Your Applications with Kayaeh/Pau-Flux: A Developer's Guide to Image Generation

In the rapidly evolving field of artificial intelligence, the ability to generate customized images can significantly enhance your applications. The Kayaeh/Pau-Flux API provides powerful Cognitive Actions that enable developers to create tailored images through advanced techniques like inpainting and image-to-image conversions. This guide will explore how you can leverage these pre-built actions to enrich your apps with dynamic visual content.

Prerequisites

Before you start integrating the Cognitive Actions into your application, ensure you have the following:

  • An API key for accessing the Kayaeh/Pau-Flux Cognitive Actions platform.
  • Familiarity with JSON format, as the API interactions will largely revolve around JSON payloads.
  • Basic understanding of making HTTP requests in your programming environment.

Authentication is typically handled by passing your API key in the request headers, allowing secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Customized Image Prediction

The Generate Customized Image Prediction action allows you to create unique images by specifying various parameters, including prompts, dimensions, and model selections. This action is particularly useful for applications that require personalized visual content.

Input

The input for this action requires the following fields:

  • generationPrompt (required): A descriptive text prompt that guides the image generation process.
  • imageMask (optional): A URI pointing to an image mask used in inpainting mode.
  • inputImage (optional): A URI of the input image for image-to-image or inpainting mode.
  • imageWidth (optional): Width of the generated image (256-1440).
  • imageHeight (optional): Height of the generated image (256-1440).
  • outputCount (optional): Number of images to generate (1-4).
  • selectedModel (optional): Choose between 'dev' or 'schnell' models for inference.
  • denoisingSteps (optional): Number of steps for denoising (1-50).
  • enableFastMode (optional): Boolean to enable fast generation mode.
  • randomSeedValue (optional): Integer to initialize randomness for repeatable results.
  • imageAspectRatio (optional): Aspect ratio for the generated image.
  • guidanceIntensity (optional): Defines the guidance scale for the diffusion process.
  • imageOutputFormat (optional): File format for output images (webp, jpg, png).
  • mainLoraIntensity and additionalLoraIntensity (optional): Control the intensity of LoRA applications.

Example Input

Here is an example JSON payload for invoking this action:

{
  "outputCount": 1,
  "selectedModel": "dev",
  "denoisingSteps": 28,
  "generationPrompt": "PAU, a 50-year-old adult female, is seen standing at the edge of a frozen lake, her military uniform blending with the snow-covered surroundings. The sky is a pale, wintry blue, and her breath forms clouds in the cold air. PAU’s face is calm, almost serene, as she surveys the landscape, planning her next move. The stillness of the lake contrasts with the ruggedness of her appearance, creating a scene of quiet strength and contemplation.",
  "imageAspectRatio": "1:1",
  "guidanceIntensity": 3.5,
  "imageOutputFormat": "webp",
  "mainLoraIntensity": 1,
  "imageOutputQuality": 90,
  "additionalLoraIntensity": 1,
  "generationPromptIntensity": 0.8
}

Output

The action will return a URL pointing to the generated image. Here’s an example of a typical output:

[
  "https://assets.cognitiveactions.com/invocations/6e081f7d-aaa2-4710-bb83-207fed26e0b4/644b3742-28f3-4a3c-8d83-6f46023eb013.webp"
]

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how to call the action using the hypothetical Cognitive Actions execution endpoint:

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 = "ab9ab7bd-f835-4678-b56c-cb45dbcc8245" # Action ID for Generate Customized Image Prediction

# Construct the input payload based on the action's requirements
payload = {
    "outputCount": 1,
    "selectedModel": "dev",
    "denoisingSteps": 28,
    "generationPrompt": "PAU, a 50-year-old adult female, is seen standing at the edge of a frozen lake...",
    "imageAspectRatio": "1:1",
    "guidanceIntensity": 3.5,
    "imageOutputFormat": "webp",
    "mainLoraIntensity": 1,
    "imageOutputQuality": 90,
    "additionalLoraIntensity": 1,
    "generationPromptIntensity": 0.8
}

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}")

This snippet shows how to structure your API request, including the action ID and input payload. The endpoint URL and request structure are illustrative and should be adjusted to align with the actual API specifications.

Conclusion

The Kayaeh/Pau-Flux Cognitive Actions provide robust capabilities for generating customized images that can enhance user experience and engagement in your applications. By utilizing the Generate Customized Image Prediction action, developers can create visually compelling content tailored to their specific needs. Explore these actions further and consider integrating them into your projects to unlock a new realm of creativity and functionality.

← Back to All Articles