Transform Your Images with the kayaeh/rafa_flux Cognitive Actions

23 Apr 2025
Transform Your Images with the kayaeh/rafa_flux Cognitive Actions

In the world of digital content creation, image processing has become a vital tool for developers seeking to enhance visual storytelling. The kayaeh/rafa_flux API offers an advanced suite of Cognitive Actions designed to seamlessly integrate sophisticated image generation capabilities into your applications. Among these actions, developers can leverage powerful features like inpainting and image transformation using state-of-the-art models. This article will delve into the "Generate Inpainted Images" action, guiding you through its functionality, input requirements, and conceptual implementation.

Prerequisites

Before you get started with the kayaeh/rafa_flux Cognitive Actions, ensure you have the following:

  • An API key from the Cognitive Actions platform to authenticate your requests.
  • Familiarity with JSON format for structuring your input and handling output data.

To authenticate, you will typically pass your API key in the request headers. This ensures secure access to the Cognitive Actions' functionalities.

Cognitive Actions Overview

Generate Inpainted Images

The Generate Inpainted Images action allows you to create inpainted or transformed images using advanced techniques such as LoRA and guidance scaling. This action is particularly useful for applications that require customized image generation based on specific prompts or existing images.

Input

The action requires a JSON payload with the following structure:

{
  "prompt": "Your descriptive text here",
  "model": "dev",
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "loraIntensity": 1,
  "outputQuality": 90,
  "promptStrength": 0.8,
  "numInferenceSteps": 28,
  "additionalLoraIntensity": 1
}

Required Fields:

  • prompt: A detailed description that guides the image creation process.

Optional Fields:

  • mask: Image mask for inpainting mode (if applicable).
  • seed: Random seed for reproducibility.
  • image: An input image for transformation.
  • model: Select between "dev" or "schnell" for inference.
  • width & height: Dimensions for custom aspect ratios.
  • goFast: Optimize speed for faster image generation.
  • megapixels: Set the image resolution.
  • numOutputs: Specify the number of images to generate.
  • aspectRatio: Define the image's aspect ratio.
  • outputFormat: Choose the output format (webp, jpg, png).
  • guidanceScale: Tweak the guidance for diffusion.
  • loraIntensity: Control the influence of the main LoRA model.
  • additionalLoraIntensity: Specify intensity for additional LoRA weights.
  • outputQuality: Adjust the quality of the output image.
  • disableSafetyChecker: Disable safety checks if needed.

Output

Upon successful execution, the action returns a JSON response containing a direct link to the generated image. For example:

[
  "https://assets.cognitiveactions.com/invocations/3806d1de-6247-4c81-adef-89807f2229d4/54dd196c-367e-40cc-b7ac-6ac07d85509b.webp"
]

If there are issues with the request, the API may return an error structure indicating what went wrong.

Conceptual Usage Example (Python)

Here’s how you can call the Generate Inpainted Images 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 = "ec4c8e71-62aa-4ca3-bb6e-a58e85572429"  # Action ID for Generate Inpainted Images

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "RAFA, a 23-year-old female fighter pilot, sits confidently in the cockpit of a Mirage 2000 jet, flying at breakneck speed above an endless desert.",
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "guidanceScale": 3.5,
    "loraIntensity": 1,
    "outputQuality": 90,
    "promptStrength": 0.8,
    "numInferenceSteps": 28,
    "additionalLoraIntensity": 1
}

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 example, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action_id corresponds to the "Generate Inpainted Images" action, and the payload contains the necessary input parameters.

Conclusion

The kayaeh/rafa_flux Cognitive Actions provide developers with powerful tools to create and manipulate images effortlessly. The Generate Inpainted Images action, in particular, opens up new avenues for creative expression and application development. By leveraging the provided capabilities, you can enhance your applications with high-quality image transformations and inpainting features.

Explore the possibilities and start integrating these Cognitive Actions into your projects today!

← Back to All Articles