Generate Stunning Images with the fofr/flux-fruit-head Cognitive Actions

23 Apr 2025
Generate Stunning Images with the fofr/flux-fruit-head Cognitive Actions

In the world of AI and machine learning, image generation has emerged as a fascinating frontier. The fofr/flux-fruit-head API offers a powerful Cognitive Action that allows developers to create images using advanced techniques, including inpainting. This provides flexibility in specifying dimensions, aspect ratios, and various settings for optimal output. By leveraging these pre-built actions, developers can seamlessly integrate image generation capabilities into their applications, enhancing user experiences and content creation processes.

Prerequisites

To get started with the Cognitive Actions provided by the fofr/flux-fruit-head spec, you'll need a few essentials:

  • An API key for the Cognitive Actions platform, which authenticates your requests.
  • Basic familiarity with making HTTP requests in your programming language of choice (e.g., Python).

Authentication generally involves passing your API key in the request headers to ensure secure access to the API's functionalities.

Cognitive Actions Overview

Generate Image Using Inpainting Mode

The Generate Image Using Inpainting Mode action is designed to perform image generation with an optional inpainting feature. This allows for the creation of images based on a text prompt while incorporating image masks for more precise editing. The action supports custom dimensions, aspect ratios, and various model settings to enhance the output quality.

Input

The input for this action requires the following fields:

  • prompt: (string, required) Text prompt guiding the image generation (e.g., "a photo of a FRUITHEAD man on a skateboard").
  • mask: (string, optional) URI of an image mask for inpainting mode.
  • image: (string, optional) Input image URI for image-to-image translation.
  • width: (integer, optional) Target width of the generated image (256 - 1440).
  • height: (integer, optional) Target height of the generated image (256 - 1440).
  • aspectRatio: (string, optional) Specifies the aspect ratio for the generated image (default is "1:1").
  • numOutputs: (integer, optional) Number of images to generate (1 - 4).
  • outputFormat: (string, optional) Desired output image format (default is "webp").
  • guidanceScale: (number, optional) Controls the guidance scale during diffusion (default is 3).
  • outputQuality: (integer, optional) Quality level for image outputs (0 - 100).
  • ... (additional fields available for fine-tuning)

Example Input:

{
  "prompt": "a photo of a FRUITHEAD man on a skateboard",
  "loraScale": 1,
  "modelType": "dev",
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "outputQuality": 90,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "numInferenceSteps": 28
}

Output

The action typically returns an array of URIs pointing to the generated images. For example:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/0d14cc3a-d84e-4244-a025-b859943e6e60/5b67096e-18f7-44a8-8788-04bddfbcada2.webp"
]

Conceptual Usage Example (Python)

Here’s how a developer might structure a request to execute 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 = "5dd13355-becd-4f8a-a649-a28052d23160" # Action ID for Generate Image Using Inpainting Mode

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "a photo of a FRUITHEAD man on a skateboard",
    "loraScale": 1,
    "modelType": "dev",
    "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 example, replace the placeholder for the API key and endpoint with your actual values. The action ID and input payload are structured to match the requirements of the Generate Image Using Inpainting Mode action.

Conclusion

The fofr/flux-fruit-head Cognitive Action for generating images presents an exciting opportunity for developers to leverage AI-driven image creation in their applications. By utilizing the inpainting mode and various customizable parameters, you can create unique and compelling visual content effortlessly. Consider exploring additional use cases, such as integrating this action into creative applications, content generation platforms, or even social media tools to enhance user engagement. Happy coding!

← Back to All Articles