Effortlessly Generate Stunning Images with Dhanushreddy291's Amused Text-to-Image Actions

22 Apr 2025
Effortlessly Generate Stunning Images with Dhanushreddy291's Amused Text-to-Image Actions

In the world of digital content creation, the ability to generate images from text prompts can be a game-changer. The dhanushreddy291/amused-text-to-image API offers powerful Cognitive Actions that allow developers to create multiple images rapidly using an innovative model based on the muse architecture. These pre-built actions enable efficient text-to-image conversion, making it easier than ever to bring your creative visions to life.

Prerequisites

Before you start using the Cognitive Actions, ensure you have the following:

  • API Key: You will need an API key to access the Cognitive Actions platform. This key is essential for authentication and should be included in the request headers.
  • Basic Setup: Familiarity with making HTTP requests in your programming language of choice (e.g., Python) will help you integrate these actions seamlessly into your application.

To authenticate your requests, you'll typically include your API key in the headers, as shown in the examples below.

Cognitive Actions Overview

Generate Images with Amused

The Generate Images with Amused action allows you to create multiple images from text prompts quickly. This action is perfect for applications that require fast and efficient image generation, leveraging the lightweight Amused model.

Input

The input for this action is defined by the following schema:

  • prompt (string, required): A descriptive text that serves as the basis for the image generation. The creativity and style of the generated images are influenced by this input.
  • guidanceScale (number, optional): A parameter that determines how closely the output should follow the prompt. The default value is 10, but higher values (up to 20) will produce results that adhere more strictly to the prompt.
  • negativePrompt (string, optional): Text that specifies unwanted characteristics in the generated images, helping to reduce their presence. Default is "3d, cgi, render, bad quality, normal quality".
  • numberOfOutputs (integer, optional): Specifies how many images to generate (1 to 4). Default is 1.
  • numberOfInferenceSteps (integer, optional): The number of inference steps to refine the output image, ranging from 10 to 50, with a default of 30.

Here’s an example of a JSON payload for invoking this action:

{
  "prompt": "a photo of a colorful lemon mocktail can with mint leaves with an abstract background",
  "guidanceScale": 20,
  "negativePrompt": "3d, cgi, render, bad quality, normal quality",
  "numberOfOutputs": 1,
  "numberOfInferenceSteps": 50
}

Output

Upon successful execution, the action returns an array of URLs pointing to the generated images. For example:

[
  "https://assets.cognitiveactions.com/invocations/73572b6a-e2e0-4936-82d9-3cd85fcb4c0a/ec15e1a5-b860-45c1-b207-cfbbad75ea34.png"
]

These URLs can be directly used to display the generated images in your application.

Conceptual Usage Example (Python)

Below is a conceptual Python code snippet illustrating how to call the Generate Images with Amused action using a hypothetical 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 = "2e34bfa3-a6e2-4f3f-a840-81d3ddf3340b"  # Action ID for Generate Images with Amused

# Construct the input payload based on the action's requirements
payload = {
    "prompt": "a photo of a colorful lemon mocktail can with mint leaves with an abstract background",
    "guidanceScale": 20,
    "negativePrompt": "3d, cgi, render, bad quality, normal quality",
    "numberOfOutputs": 1,
    "numberOfInferenceSteps": 50
}

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 corresponds to the Generate Images with Amused action, and the payload is structured according to the required input schema.

Conclusion

The dhanushreddy291/amused-text-to-image Cognitive Actions offer a straightforward and efficient way to generate images from text prompts. With the ability to customize prompts, adjust guidance scales, and specify the number of images, developers can easily integrate image generation capabilities into their applications. Start exploring these actions today, and unlock new creative possibilities for your projects!

← Back to All Articles