Create Stunning Images with the adirik/flux-cinestill Cognitive Actions

24 Apr 2025
Create Stunning Images with the adirik/flux-cinestill Cognitive Actions

In the world of image generation, the adirik/flux-cinestill API offers powerful Cognitive Actions that enable developers to create visually stunning images using the advanced FLUX LoRA model. With customizable parameters, these actions provide flexibility in generating outputs that fit various creative needs. This article will guide you through the capabilities of the primary action available in this spec and demonstrate how you can integrate it into your applications.

Prerequisites

Before you start using the Cognitive Actions, ensure you have the following:

  • An API key for the Cognitive Actions platform.
  • Basic knowledge of JSON and API requests.
  • Familiarity with making HTTP requests in your programming language of choice.

For authentication, you typically need to pass your API key in the request headers, which will allow you to securely access the Cognitive Actions.

Cognitive Actions Overview

Generate Image via FLUX LoRA

The Generate Image via FLUX LoRA action allows you to create images using the FLUX LoRA model. You can customize various parameters such as style intensity, output quality, and image dimensions. This action also utilizes 'CNSTLL' as a trigger to enhance specific styles or concepts, making it a versatile tool for image generation.

Input

The input schema for this action requires the following fields:

  • prompt (required): A string that describes the image you want to generate. Including specific trigger words can enhance the outcome.
  • Other optional fields allow for fine-tuning, including model, width, height, aspectRatio, and several parameters to adjust image qualities such as guidanceScale, mainLoraStrength, and more.

Here’s an example of the JSON payload needed to invoke this action:

{
  "model": "dev",
  "prompt": "CNSTLL, Road trip, view through car window of desert highway\n",
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "numberOfOutputs": 1,
  "mainLoraStrength": 0.6,
  "additionalLoraStrength": 0.8,
  "numberOfInferenceSteps": 28
}

Output

Upon successful execution, the action typically returns a URL to the generated image. Here’s an example of the output you might receive:

[
  "https://assets.cognitiveactions.com/invocations/2c0c92ec-65bf-4d0d-90df-19b81a75281f/00e27997-1b10-4e96-904f-254b06222d68.webp"
]

This URL points to the generated image, which can be accessed directly.

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet demonstrating how you might call the Generate Image via FLUX LoRA action using the Cognitive Actions API:

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 = "1ab2135b-1d5a-44d6-b71f-7e0ea9b69304" # Action ID for Generate Image via FLUX LoRA

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "CNSTLL, Road trip, view through car window of desert highway\n",
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "guidanceScale": 3.5,
    "outputQuality": 80,
    "numberOfOutputs": 1,
    "mainLoraStrength": 0.6,
    "additionalLoraStrength": 0.8,
    "numberOfInferenceSteps": 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, you'll need to replace YOUR_COGNITIVE_ACTIONS_API_KEY with your actual API key. The code prepares the input JSON payload, sets the necessary headers, and makes a POST request to the action's execution endpoint.

Conclusion

The adirik/flux-cinestill Cognitive Actions offer a robust solution for developers looking to integrate image generation capabilities into their applications. By leveraging the FLUX LoRA model, you can create stunning visuals tailored to your specific requirements. Start experimenting with the Generate Image via FLUX LoRA action and unlock new creative possibilities in your projects!

← Back to All Articles