Create Stunning Images with the ebony59/flux_athome_1 Cognitive Actions

In today's digital landscape, generating high-quality images programmatically can elevate applications and deliver unique experiences. The ebony59/flux_athome_1 Cognitive Actions provide developers with powerful tools to create custom images tailored to their needs. These actions leverage advanced models that support image inpainting, various aspect ratios, and fast generation options. With these pre-built actions, developers can seamlessly integrate image generation capabilities into their applications, enhancing visual content without extensive manual effort.

Prerequisites

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

• An API key for accessing the Cognitive Actions platform.
• Basic familiarity with JSON and RESTful APIs.
• A development environment set up for making HTTP requests.

Authentication typically involves including your API key in the request headers, allowing secure access to the Cognitive Actions.

Cognitive Actions Overview

Generate Custom Image

Description:
The Generate Custom Image action creates custom images based on a provided text prompt. It offers options for image inpainting, different aspect ratios, and supports two models: the 'dev' model for detailed images and the 'schnell' model for quick results.

Category: Image Generation

Input

• Required:
  • prompt: A string that describes the image to be generated.
• Optional:
  • mask: URI for the image mask used in inpainting mode.
  • seed: Integer for reproducible image generation.
  • image: URI of an input image for inpainting or image-to-image transformation.
  • width: Image width in pixels (only for custom aspect ratios).
  • height: Image height in pixels (only for custom aspect ratios).
  • aspectRatio: The aspect ratio of the generated image (default is 1:1).
  • outputCount: Number of images to generate (default is 1).
  • outputFormat: Format of the generated images (e.g., webp, jpg, png).
  • guidanceScale: Influence of the prompt during image generation (default is 3).
  • loraIntensity: Strength of the main LoRA application (default is 1).
  • outputQuality: Quality of the output image (default is 80).
  • enableFastMode: Toggles fast predictions using optimized models (default is false).
  • extraLoraScale: Strength for applying additional LoRA (default is 1).
  • inferenceModel: The model used for inference (default is dev).
  • promptStrength: Strength of the prompt for image modifications (default is 0.8).
  • imageResolution: Approximate image resolution in megapixels (default is 1).
  • loadLoraWeights: Load compatible LoRA weights.
  • inferenceStepCount: Specifies the number of denoising steps (default is 28).
  • bypassSafetyChecker: Allows bypassing the built-in safety checker (default is false).
  • additionalLoraWeights: Load additional LoRA weights from various sources.

Example Input:

{
  "prompt": "A minimalist ceramic german shepherd table decoration, white background, for retailer athome",
  "aspectRatio": "1:1",
  "outputCount": 1,
  "outputFormat": "webp",
  "guidanceScale": 3,
  "loraIntensity": 1,
  "outputQuality": 80,
  "enableFastMode": false,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageResolution": "1",
  "inferenceStepCount": 28
}

Output

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

[
  "https://assets.cognitiveactions.com/invocations/afb08633-5ff7-4d08-9432-43b3bcd69da1/47f97f2d-0ac9-484d-b25c-78a23924a6c5.webp"
]

Conceptual Usage Example (Python)

Here’s how a developer might execute the Generate Custom Image action using a hypothetical Cognitive Actions API endpoint:

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 = "4bf3c433-a6d8-4286-9908-81e668faa612" # Action ID for Generate Custom Image

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "A minimalist ceramic german shepherd table decoration, white background, for retailer athome",
    "aspectRatio": "1:1",
    "outputCount": 1,
    "outputFormat": "webp",
    "guidanceScale": 3,
    "loraIntensity": 1,
    "outputQuality": 80,
    "enableFastMode": False,
    "extraLoraScale": 1,
    "inferenceModel": "dev",
    "promptStrength": 0.8,
    "imageResolution": "1",
    "inferenceStepCount": 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 code snippet, replace "YOUR_COGNITIVE_ACTIONS_API_KEY" with your actual API key. The action ID and input payload align with the requirements specified in the action schema.

Conclusion

The ebony59/flux_athome_1 Cognitive Actions empower developers to effortlessly generate custom images tailored to specific needs. By utilizing the Generate Custom Image action, you can enhance the visual appeal of your applications while saving time and resources. Consider exploring different input parameters to achieve varying styles and qualities in your generated images. Happy coding!