Generate Stunning Images with the jarvis-labs2024/flux-appleseed Cognitive Actions

22 Apr 2025
Generate Stunning Images with the jarvis-labs2024/flux-appleseed Cognitive Actions

In the world of AI and machine learning, the ability to generate high-quality images is revolutionizing creative fields. The jarvis-labs2024/flux-appleseed API offers powerful Cognitive Actions that enable developers to generate enhanced images with remarkable detail and customization. With features like inpainting, aspect ratio adjustments, and varied model selections, these pre-built actions can streamline image creation and enhance application capabilities.

Prerequisites

To integrate the Cognitive Actions, you will need:

  • An API key for authentication to access the Cognitive Actions platform.
  • Basic knowledge of making API calls and handling JSON payloads.

Authentication typically involves passing the API key in the request headers. This allows you to securely access the services provided by the API.

Cognitive Actions Overview

Generate Enhanced Image With Mask

The Generate Enhanced Image With Mask action is designed to create high-quality images using either image-to-image or inpainting modes. It supports various customization options such as aspect ratios, output formats, and precision levels, making it suitable for a range of creative applications.

Input

The input schema for this action is structured as follows:

{
  "prompt": "string",
  "mask": "string (optional)",
  "seed": "integer (optional)",
  "image": "string (optional)",
  "width": "integer (optional)",
  "goFast": "boolean (optional)",
  "height": "integer (optional)",
  "loraStrength": "number (optional)",
  "guidanceScale": "number (optional)",
  "outputQuality": "integer (optional)",
  "selectedModel": "string (optional)",
  "promptStrength": "number (optional)",
  "numberOfOutputs": "integer (optional)",
  "alternateWeights": "string (optional)",
  "approxMegapixels": "string (optional)",
  "imageAspectRatio": "string (optional)",
  "imageOutputFormat": "string (optional)",
  "numInferenceSteps": "integer (optional)",
  "disableSafetyChecker": "boolean (optional)",
  "additionalLoraWeights": "string (optional)",
  "additionalLoraStrength": "number (optional)"
}

Example Input:

{
  "prompt": "A dynamic scene from the Appleseed manga featuring two characters in a futuristic setting. The character on the left is a female warrior in a sleek blue suit wielding a weapon while the character on the right is a male in a purple and black outfit with a robotic arm. They are standing on a platform with a green and yellow background suggesting a high-tech environment",
  "loraStrength": 1,
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "selectedModel": "dev",
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "numInferenceSteps": 28
}

Output

The output of this action typically returns a URL linking to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/f8bdbc46-4bae-42cc-9aca-73fea8dab8ee/dfd1fc7b-778f-4770-9535-0ef67b017503.webp"
]

Conceptual Usage Example (Python)

Here's a conceptual Python snippet demonstrating how to call this action:

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 = "9dd2decb-06ee-4c44-a0ae-0afed9fd04ed" # Action ID for Generate Enhanced Image With Mask

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "A dynamic scene from the Appleseed manga featuring two characters in a futuristic setting. The character on the left is a female warrior in a sleek blue suit wielding a weapon while the character on the right is a male in a purple and black outfit with a robotic arm. They are standing on a platform with a green and yellow background suggesting a high-tech environment",
    "loraStrength": 1,
    "guidanceScale": 3.5,
    "outputQuality": 80,
    "selectedModel": "dev",
    "numberOfOutputs": 1,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "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 YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The payload variable is structured according to the required inputs for the action. The request is sent to the hypothetical endpoint, and the response is printed to the console.

Conclusion

By leveraging the jarvis-labs2024/flux-appleseed Cognitive Actions, developers can enhance their applications with powerful image generation capabilities. From creating detailed scenes to customizing outputs, these actions provide the tools needed for creativity and innovation in digital content creation. Explore the possibilities and consider integrating these actions into your next project!

← Back to All Articles