Transform Your Images: A Developer's Guide to emunozhern/fluxtok Cognitive Actions

21 Apr 2025
Transform Your Images: A Developer's Guide to emunozhern/fluxtok Cognitive Actions

The emunozhern/fluxtok API provides developers with powerful Cognitive Actions that enable high-quality image generation and manipulation. Utilizing advanced image-to-image conversion techniques, these actions allow for customizable settings such as aspect ratio, image quality, and more. With the pre-built capabilities of these actions, developers can easily integrate sophisticated image processing into their applications without needing extensive background in image generation.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and RESTful APIs for effective interaction.

Authentication typically involves passing your API key in the headers of your requests, ensuring secure and authorized access to the available actions.

Cognitive Actions Overview

Generate Inpainted Images

The Generate Inpainted Images action creates high-quality images by utilizing image-to-image conversion. It supports various output formats and customizable settings, making it ideal for developers looking to enhance their applications with advanced image generation capabilities.

Input

The input for this action requires a JSON object. Below are the key properties:

  • prompt (required): A descriptive text guiding the image generation.
  • mask (optional): URI of the image mask for inpainting.
  • image (optional): URI of the input image for transformations.
  • width (optional): Specifies the width of the output image in pixels.
  • height (optional): Specifies the height of the output image in pixels.
  • imageFormat (optional): The desired format for the output image (default is "webp").
  • outputCount (optional): Number of output images to generate (default is 1).
  • imageQuality (optional): Quality level from 0 (lowest) to 100 (highest).
  • inferenceModel (optional): Selects the inference model ("dev" or "schnell").
  • inferenceSteps (optional): Number of denoising steps (default is 28).

Example Input:

{
  "prompt": "A stylish woman confidently applies TOK on her neck, with an elegant smile. The scene captures her in a luxurious setting with soft lighting that highlights her elegance. The perfume bottle shines subtly in her hand, adding a touch of sophistication to the moment.",
  "imageFormat": "webp",
  "outputCount": 1,
  "imageQuality": 90,
  "mainLoraScale": 1.12,
  "inferenceModel": "dev",
  "inferenceSteps": 28,
  "promptInfluence": 1,
  "outputAspectRatio": "1:1",
  "diffusionGuidanceScale": 3,
  "additionalLoraInfluence": 1.7
}

Output

The action typically returns a list of URLs pointing to the generated images. For example:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/8efb0143-4561-47df-ab22-6db6ee2a85e6/b9331da3-07a0-41b4-8623-208912616e57.webp"
]

Conceptual Usage Example (Python)

Here's how you might call this 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 = "16da4a44-de09-4c73-8aa0-c191c4665aaa"  # Action ID for Generate Inpainted Images

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "A stylish woman confidently applies TOK on her neck, with an elegant smile. The scene captures her in a luxurious setting with soft lighting that highlights her elegance. The perfume bottle shines subtly in her hand, adding a touch of sophistication to the moment.",
    "imageFormat": "webp",
    "outputCount": 1,
    "imageQuality": 90,
    "mainLoraScale": 1.12,
    "inferenceModel": "dev",
    "inferenceSteps": 28,
    "promptInfluence": 1,
    "outputAspectRatio": "1:1",
    "diffusionGuidanceScale": 3,
    "additionalLoraInfluence": 1.7
}

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 Python code snippet, replace the placeholder API key and endpoint with your actual values. The input payload is structured according to the requirements of the Generate Inpainted Images action.

Conclusion

Integrating the emunozhern/fluxtok Cognitive Actions into your applications can significantly enhance your image processing capabilities. With the ability to create high-quality, customized images, you can unlock new possibilities for creativity and innovation in your projects. Explore the various parameters available in the Generate Inpainted Images action to tailor the output to your specific needs, and start transforming your images today!

← Back to All Articles