Generate Stunning Images with asiryan/flux-schnell Cognitive Actions

23 Apr 2025
Generate Stunning Images with asiryan/flux-schnell Cognitive Actions

In the world of digital content creation, having the ability to generate high-quality images quickly can be a game-changer. The asiryan/flux-schnell API offers a powerful Cognitive Action designed specifically for this purpose: the Generate Image with FLUX Schnell Model. This action allows developers to create images from descriptive text (Text2Img) or transform existing images (Img2Img) with customizable parameters, enabling a wide range of creative applications.

Prerequisites

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

  • An API key for the Cognitive Actions platform.
  • Basic understanding of JSON and RESTful APIs.
  • Familiarity with Python for implementing the example code.

Authentication typically involves passing the API key in the request headers, ensuring that your requests are authorized to access the Cognitive Actions.

Cognitive Actions Overview

Generate Image with FLUX Schnell Model

The Generate Image with FLUX Schnell Model action is designed to create high-quality images based on text prompts or by modifying existing images. This flexibility makes it an invaluable tool for developers looking to enhance their applications with custom image generation capabilities.

Input

The input for this action requires a JSON object with the following fields:

  • seed (integer, optional): A random seed for image generation, allowing for reproducibility.
  • image (string, optional): A URI of the input image for Img2Img mode; the output will match its aspect ratio.
  • width (integer, default: 1024): The width of the output image in pixels.
  • height (integer, default: 1024): The height of the output image in pixels.
  • prompt (string, default: "a tiny astronaut hatching from an egg on the moon"): A detailed text description to guide image generation.
  • outputFormat (string, default: "png"): The desired file format for the output image (options: webp, jpg, png).
  • outputQuality (integer, default: 100): The quality of the output image, ranging from 0 to 100.
  • promptStrength (number, default: 0.8): The strength of the prompt in Img2Img mode, ranging from 0 to 1.
  • numberOfOutputs (integer, default: 1): Total number of images to generate (1 to 4).
  • numberOfInferenceSteps (integer, default: 4): Steps used during inference to affect image detail (1 to 12).

Example Input:

{
  "width": 1024,
  "height": 1024,
  "prompt": "black forest gateau cake spelling out the words \"FLUX SCHNELL\", tasty, food photography, dynamic shot",
  "outputFormat": "png",
  "outputQuality": 100,
  "promptStrength": 0.8,
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 4
}

Output

The action returns a URL to the generated image. The output may look like this:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/491f40f2-8bce-4761-be71-56eafcbfa10a/57b6bd20-fea7-4853-a4da-5fa7a3ed15b2.png"
]

Conceptual Usage Example (Python)

Here's a conceptual Python code snippet demonstrating how to invoke 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 = "6075d13d-2d40-41e5-9538-3a7457d5862f" # Action ID for Generate Image with FLUX Schnell Model

# Construct the input payload based on the action's requirements
payload = {
    "width": 1024,
    "height": 1024,
    "prompt": "black forest gateau cake spelling out the words \"FLUX SCHNELL\", tasty, food photography, dynamic shot",
    "outputFormat": "png",
    "outputQuality": 100,
    "promptStrength": 0.8,
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 4
}

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 COGNITIVE_ACTIONS_API_KEY and COGNITIVE_ACTIONS_EXECUTE_URL with your actual API key and endpoint. The action_id corresponds to the action you want to execute, and the payload is structured according to the action's input schema.

Conclusion

The Generate Image with FLUX Schnell Model Cognitive Action opens up a world of possibilities for developers looking to enhance their applications with dynamic image generation capabilities. By integrating this action into your projects, you can offer users the ability to create custom visuals that meet their unique needs.

Whether you're building a creative platform, an e-commerce site, or any application that benefits from custom imagery, this action is a valuable asset. Explore the potential of the asiryan/flux-schnell API today and start generating stunning images!

← Back to All Articles