Enhance Facial Image Textures with the batchbinary/flux-qfaces Cognitive Actions

23 Apr 2025
Enhance Facial Image Textures with the batchbinary/flux-qfaces Cognitive Actions

In the realm of image processing, enhancing the quality and details of facial images can significantly improve user engagement and visual appeal. The batchbinary/flux-qfaces specification provides a powerful Cognitive Action designed for this purpose. By leveraging the QFACES model, developers can enhance facial textures and details in images with a focus on preserving essential characteristics across diverse ages and ethnicities. This action is particularly beneficial for applications requiring image-to-image transformations, especially in close-up photographs.

Prerequisites

Before integrating the Cognitive Actions from the batchbinary/flux-qfaces specification into your application, ensure that you have the following:

  • An API key for the Cognitive Actions platform, which will be used for authentication.
  • Basic knowledge of making API calls and handling JSON payloads.

To authenticate, you will typically pass your API key in the headers of your requests.

Cognitive Actions Overview

Enhance Facial Image Textures

Description: Improve facial textures and details in images using the QFACES model. This operation enhances high-quality images of diverse people across different ages and ethnicities, making them ideal for image-to-image transformation with a focus on preserving core details. It's best suited for close-up photos and allows for adjustments in prompt strength and guidance scale to optimize results.

Category: Image Enhancement

Input: The input for this action requires the following fields:

  • prompt (required): Text input used to generate the image.
  • image (required): URI of the input image for image-to-image or inpainting mode.
  • model (optional): Select the model for inference (default: "dev").
  • width (optional): Specify the width of the generated image in pixels (if aspect ratio is custom).
  • height (optional): Specify the height of the generated image in pixels (if aspect ratio is custom).
  • guidanceScale (optional): Adjust the guidance scale for the diffusion process (default: 3).
  • outputQuality (optional): Adjust the quality of the output images on a scale from 0 to 100 (default: 80).
  • numberOfOutputs (optional): Number of outputs to generate (default: 1).
  • imageAspectRatio (optional): Select the aspect ratio for the image being generated (default: "1:1").
  • Additional parameters like seed, goFast, promptStrength, and more can also be included.

Example Input:

{
  "seed": 42,
  "image": "https://replicate.delivery/pbxt/MFoN60GJkZUE5qH6bejQ3yQBG2pXHIIT6nmIF9ObWmCkYEFu/test-A4-CF-thenCR1.png",
  "model": "dev",
  "width": 1440,
  "goFast": false,
  "height": 1440,
  "prompt": "photo, high resolution, face, high quality, QFACES, photograph, skin, hair, detailed, maximum definition, 4k, highres,",
  "loraScale": 1,
  "megapixels": "1",
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceSteps": 50,
  "promptStrength": 0.4,
  "numberOfOutputs": 1,
  "imageAspectRatio": "custom",
  "imageOutputFormat": "png"
}

Output: The action returns a list of URLs pointing to the enhanced images. Here’s an example of what the output might look like:

[
  "https://assets.cognitiveactions.com/invocations/5c9c5566-89c0-44ef-b0e6-a1c640e13988/f2b17141-4d84-422f-83a9-55884b75c14d.png"
]

Conceptual Usage Example (Python): Here’s how you might call this action programmatically:

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 = "0204ef44-f1d3-4fc5-ab7f-e4b1438141af" # Action ID for Enhance Facial Image Textures

# Construct the input payload based on the action's requirements
payload = {
    "seed": 42,
    "image": "https://replicate.delivery/pbxt/MFoN60GJkZUE5qH6bejQ3yQBG2pXHIIT6nmIF9ObWmCkYEFu/test-A4-CF-thenCR1.png",
    "model": "dev",
    "width": 1440,
    "goFast": False,
    "height": 1440,
    "prompt": "photo, high resolution, face, high quality, QFACES, photograph, skin, hair, detailed, maximum definition, 4k, highres,",
    "loraScale": 1,
    "megapixels": "1",
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "inferenceSteps": 50,
    "promptStrength": 0.4,
    "numberOfOutputs": 1,
    "imageAspectRatio": "custom",
    "imageOutputFormat": "png"
}

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 code, be sure to replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The payload variable is constructed using the example input provided, and the request is sent to the hypothetical endpoint to execute the action.

Conclusion

The batchbinary/flux-qfaces Cognitive Action for enhancing facial image textures is a robust tool for developers looking to improve image quality in their applications. By utilizing this action, you can create visually stunning images that preserve critical details while adapting to various user needs. Explore the possibilities and start integrating this technology into your projects today!

← Back to All Articles