Generate Stunning Images with the rainer1966-de/flux_rainer Cognitive Actions

21 Apr 2025
Generate Stunning Images with the rainer1966-de/flux_rainer Cognitive Actions

In the realm of image generation, the rainer1966-de/flux_rainer API provides powerful Cognitive Actions designed to facilitate creative workflows for developers. By leveraging inpainting techniques, these actions allow for efficient image transformations, enabling you to create custom images with specified attributes. With features like seed-based reproducibility and optimized performance models, you can generate high-quality visuals tailored to your needs.

Prerequisites

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

  • An API key for the Cognitive Actions platform to authenticate your requests.
  • Familiarity with handling JSON payloads within a programming environment.
  • Basic understanding of making HTTP requests to execute API actions.

Authentication typically involves passing your API key in the request headers, which will be demonstrated in the conceptual usage examples.

Cognitive Actions Overview

Generate Image with Inpainting

Description:
This action enables developers to generate images using advanced inpainting techniques. It supports various customizations, such as aspect ratios, seed values for reproducibility, and model selection for optimal performance.

Category: image-generation

Input

The input schema for this action is a structured JSON object. Here’s a breakdown of the required and optional fields:

  • Required:
    • prompt: A text description guiding the image generation (e.g., “photo of rainerLinkedIn…”).
  • Optional:
    • mask: URI of an image mask for inpainting.
    • seed: Integer for random number generation.
    • image: URI of the input image for transformation.
    • model: Select between "dev" (default) or "schnell".
    • width & height: Dimensions of the generated image (only applicable for custom aspect ratios).
    • outputCount: Number of images to generate (default is 1, max 4).
    • imageAspectRatio: Aspect ratio for the generated image.
    • imageOutputFormat: Output format (e.g., webp, jpg, png).
    • And more...

Example Input:

{
  "model": "dev",
  "prompt": "photo of rainerLinkedIn on th emarket place of an histric old village, very laughing, big crowd, holding a newspaper \"New Work Times\" in his right hand, dark suit, a white shirt and a tie with the logo from the trained model rainerLinkedIn, holding a microphone, no ring at his fingers, all people in th ebackground are not be similar to rainerLinkedIn, realistic photo",
  "outputCount": 1,
  "loraWeightScale": 1,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "imageOutputQuality": 80,
  "additionalLoraScale": 0.8,
  "inferenceStepsCount": 28,
  "diffusionGuidanceScale": 3.5
}

Output

The output of this action is a JSON array containing URIs of the generated images. The example output is as follows:

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/1d17faea-3f01-45bb-9087-42c189270efe/a14f4ece-06d7-4cba-b267-ced3b6d82ad5.webp"
]

Conceptual Usage Example (Python)

Here’s how you might structure a Python script to call this 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 = "dd72eb4d-3a06-4acd-9e6f-e6677c99abbf"  # Action ID for Generate Image with Inpainting

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "prompt": "photo of rainerLinkedIn on th emarket place of an histric old village, very laughing...",
    "outputCount": 1,
    "loraWeightScale": 1,
    "imageAspectRatio": "1:1",
    "imageOutputFormat": "webp",
    "imageOutputQuality": 80,
    "additionalLoraScale": 0.8,
    "inferenceStepsCount": 28,
    "diffusionGuidanceScale": 3.5
}

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, the action ID for “Generate Image with Inpainting” and the input payload are clearly defined, making it straightforward to execute the action and retrieve the generated images.

Conclusion

The rainer1966-de/flux_rainer Cognitive Actions empower developers to harness the capabilities of advanced image generation and inpainting techniques. By integrating these actions into your applications, you can create stunning visuals tailored to specific requirements effortlessly. Consider experimenting with different parameters to explore the full range of creative possibilities!

← Back to All Articles