Generate Stunning Images with galverse/mama-flux-v1 Cognitive Actions

25 Apr 2025
Generate Stunning Images with galverse/mama-flux-v1 Cognitive Actions

Integrating advanced image generation capabilities into your applications can significantly enhance user experience. The galverse/mama-flux-v1 spec provides a powerful Cognitive Action designed to generate customized images. This action utilizes state-of-the-art models for image-to-image transformations and inpainting, allowing developers to create detailed visual content with various control parameters. By leveraging these pre-built actions, developers can save time and focus on building unique features in their applications.

Prerequisites

Before diving into the details of the Cognitive Actions, ensure that you have the following prerequisites in place:

  • API Key: To access the Cognitive Actions platform, you will need an API key. This key should be passed in the headers of your requests for authentication.
  • Network Access: Ensure your application can make HTTP requests to the Cognitive Actions endpoint.

Cognitive Actions Overview

Generate Customized Images

The Generate Customized Images action allows you to create images based on specific prompts, with options for various customization settings, including image aspect ratio and output format. This action falls under the category of image-generation.

Input: The required input fields for this action are defined in the schema. Below is an overview of the key parameters:

  • prompt (required): A detailed description of the image you want to generate.
  • model: Selects the inference model to use, with options for "dev" and "schnell".
  • aspectRatio: Determines the aspect ratio of the generated image.
  • outputCount: Specifies how many images to generate.
  • outputFormat: The format of the generated image (e.g., webp, jpg, png).

Here’s an example of a JSON payload that can be used to invoke this action:

{
  "model": "dev",
  "prompt": "low angles, A girl with royal blue short bob hair, straight bangs, sharp eyes, big text saying \"GALVERSE\" in the sky, she is wearing a black bodysuit with many gadgets, standing on the roof of a building, She holding a red linear sci-fi design electric guitar, many neon sign, hong kong city at night, back light, retro 1990 anime , in the style of GALVERSE",
  "loraScale": 1,
  "aspectRatio": "4:5",
  "outputCount": 1,
  "outputFormat": "webp",
  "guidanceScale": 3.5,
  "outputQuality": 80,
  "inferenceStepCount": 28,
  "additionalLoraStrength": 0.8
}

Output: The action will return a URL to the generated image. Below is an example of a typical output:

[
  "https://assets.cognitiveactions.com/invocations/a65f00ee-d779-4989-ae0e-07978a730d19/2a1a114b-043f-4a58-ad70-2b17b0032f82.webp"
]

Conceptual Usage Example (Python)

Here’s how you might call the Generate Customized Images action using a Python script:

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 = "b61f19c1-c0e1-49ca-be21-88cbbb05e289"  # Action ID for Generate Customized Images

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "low angles, A girl with royal blue short bob hair, straight bangs, sharp eyes, big text saying \"GALVERSE\" in the sky, she is wearing a black bodysuit with many gadgets, standing on the roof of a building, She holding a red linear sci-fi design electric guitar, many neon sign, hong kong city at night, back light, retro 1990 anime , in the style of GALVERSE",
    "loraScale": 1,
    "aspectRatio": "4:5",
    "outputCount": 1,
    "outputFormat": "webp",
    "guidanceScale": 3.5,
    "outputQuality": 80,
    "inferenceStepCount": 28,
    "additionalLoraStrength": 0.8
}

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, make sure to replace the COGNITIVE_ACTIONS_API_KEY and endpoint URL with your actual values. The action ID and the input payload are structured to match the requirements of the Generate Customized Images action.

Conclusion

The galverse/mama-flux-v1 Cognitive Actions provide a robust solution for generating customized images tailored to your application's needs. By leveraging the capabilities of advanced image generation models, developers can create unique visual content efficiently. Consider exploring other use cases where image generation can enhance user engagement and creativity in your projects. Happy coding!

← Back to All Articles