Create Stunning Images from Text Prompts with ameurka/amazing Cognitive Actions

22 Apr 2025
Create Stunning Images from Text Prompts with ameurka/amazing Cognitive Actions

In the world of artificial intelligence, the ability to generate high-quality images from text prompts is a game-changer. The ameureka/amazing API offers developers a powerful set of Cognitive Actions specifically designed for image generation. With these pre-built actions, you can seamlessly integrate advanced image creation capabilities into your applications, enhancing user experiences and visual storytelling.

Prerequisites

Before you begin integrating the Cognitive Actions from the ameureka/amazing API, ensure you have the following prerequisites:

  • An API key for the Cognitive Actions platform.
  • Familiarity with making HTTP requests and handling JSON data.

Authentication typically involves passing your API key in the headers of your HTTP requests, allowing you to securely access the available actions.

Cognitive Actions Overview

Generate Enhanced Image

The Generate Enhanced Image action allows you to create high-quality images from descriptive text prompts. It leverages advanced image inpainting and fast prediction capabilities, supporting custom aspect ratios, multiple output formats, and model optimizations tailored for precision and performance needs.

Input

The input for this action is defined by a schema requiring a prompt string. Here’s a breakdown of the relevant fields:

  • prompt (required): The text prompt used to generate the image.
  • model (optional): Choose between "dev" or "schnell" for inference.
  • goFast (optional): Enable faster predictions if set to true.
  • aspectRatio (optional): Set the aspect ratio for the generated image.
  • numOutputs (optional): Specify the number of images to generate (1 to 4).
  • Additional optional fields include seed, width, height, and various other parameters to fine-tune the output.

Example Input:

{
  "model": "dev",
  "goFast": false,
  "prompt": "Lynn successfully reached the summit of Mount Everest.",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "1:1",
  "outputFormat": "webp",
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "numInferenceSteps": 28
}

Output

The output of this action will typically return a URL pointing to the generated image.

Example Output:

[
  "https://assets.cognitiveactions.com/invocations/65789d5f-127b-4ff9-8bd5-acd17bb15f2f/f8fdb709-2647-4a36-88ad-4844adc83078.webp"
]

Conceptual Usage Example (Python)

Here’s a conceptual Python code snippet to illustrate how you might call the Generate Enhanced Image action:

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 = "ec73de73-fcbe-4924-a6d4-84ec4baad219" # Action ID for Generate Enhanced Image

# Construct the input payload based on the action's requirements
payload = {
    "model": "dev",
    "goFast": False,
    "prompt": "Lynn successfully reached the summit of Mount Everest.",
    "loraScale": 1,
    "numOutputs": 1,
    "aspectRatio": "1:1",
    "outputFormat": "webp",
    "guidanceScale": 3,
    "outputQuality": 80,
    "extraLoraScale": 1,
    "promptStrength": 0.8,
    "imageMegapixels": "1",
    "numInferenceSteps": 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 payload variable should match the required input schema for the Generate Enhanced Image action. The endpoint URL and request structure are hypothetical and meant for illustrative purposes.

Conclusion

The ameureka/amazing Cognitive Actions empower developers to create stunning images from text prompts effortlessly. By integrating these actions, you can enhance your applications with advanced image generation capabilities, opening up a world of creative possibilities. Explore the various parameters for fine-tuning your images, and start building visually engaging experiences today!

← Back to All Articles