Create Stunning Images with the Steven-Altitude Toniflux Cognitive Actions

22 Apr 2025
Create Stunning Images with the Steven-Altitude Toniflux Cognitive Actions

In today's digital landscape, the demand for high-quality, customized images is greater than ever. The Steven-Altitude Toniflux API offers powerful Cognitive Actions designed to generate stunning images tailored to your specific needs. By leveraging state-of-the-art inpainting and image-to-image transformation, developers can create high-resolution images with enhanced quality and speed. In this article, we will explore how to effectively utilize the Generate Customized Image action to elevate your application's visual content.

Prerequisites

Before diving into the integration, ensure you have the following:

  • API Key: You will need an API key for the Cognitive Actions platform, which will be used for authentication.
  • Basic Setup: Familiarity with making HTTP requests and handling JSON data in your programming environment.

Authentication typically involves passing the API key in the request headers, granting you access to the Cognitive Actions.

Cognitive Actions Overview

Generate Customized Image

Description: This action creates high-resolution images using advanced techniques like inpainting and image-to-image transformation. You can choose from different models based on your quality and speed requirements.

Category: Image Generation

Input

The action accepts the following input parameters:

  • prompt (required): A detailed description of the desired image.
  • model (optional): Choose between "dev" for optimal quality or "schnell" for faster generation. Default is "dev".
  • image (optional): An input image for transformations or inpainting.
  • mask (optional): An image mask for inpainting mode.
  • width (optional): Specifies the width of the generated image.
  • height (optional): Specifies the height of the generated image.
  • megapixels (optional): Defines the approximate number of megapixels.
  • outputFormat (optional): The format of the output image ("webp", "jpg", "png").
  • guidanceScale (optional): Affects the image realism; default is 3.
  • numberOfOutputs (optional): Number of images to generate, ranging from 1 to 4.
  • imageAspectRatio (optional): Selects the aspect ratio for the generated image.
  • Additional parameters control various aspects of the image generation process, including output quality, prompt strength, and more.

Example Input:

{
  "model": "dev",
  "prompt": "A high-resolution, romantic product photograph of LECHETONI, a premium semi-skimmed milk in a red and white carton, elegantly placed on a beautifully set Valentine's Day table.",
  "megapixels": "1",
  "outputFormat": "webp",
  "guidanceScale": 3,
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1"
}

Output

The action typically returns a URL pointing to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/457d3faa-e0a4-404d-9f13-514f2d080ef9/7033d50d-4163-4f33-88cb-1f36e6f9ccf7.webp"
]

Conceptual Usage Example (Python)

Here’s how a developer might call the Generate Customized Image 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 = "4c6e5e24-5ce8-4deb-b6a9-96613a192f4b"  # Action ID for Generate Customized Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "A high-resolution, romantic product photograph of LECHETONI, a premium semi-skimmed milk in a red and white carton, elegantly placed on a beautifully set Valentine's Day table.",
    "megapixels": "1",
    "outputFormat": "webp",
    "guidanceScale": 3,
    "numberOfOutputs": 1,
    "imageAspectRatio": "1:1"
}

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 notice how the action ID and input payload are structured to make the API call. The endpoint URL and request structure provided are illustrative and should be adapted to your specific implementation.

Conclusion

The Generate Customized Image action from the Steven-Altitude Toniflux API is a powerful tool for developers looking to create high-quality, tailored images for their applications. By utilizing its various parameters, you can refine the image generation process to meet your specific needs. Explore further by integrating this action into your application and watch as your visual content transforms!

← Back to All Articles