image-generation

Create Stunning AI-Enhanced Images with Joy's Cognitive Actions

27 Apr 2025
Create Stunning AI-Enhanced Images with Joy's Cognitive Actions

In today's digital landscape, visual content plays a crucial role in engaging audiences and conveying messages effectively. The "Joy" service brings powerful Cognitive Actions to developers, enabling the generation of AI-enhanced images that are not only visually appealing but also tailored to specific needs. By leveraging advanced image inpainting and conversion capabilities, developers can produce high-quality images quickly and efficiently, enhancing their applications and projects.

Imagine the possibilities: creating unique artwork, generating assets for games, or even crafting marketing materials that stand out. With options for aspect ratio, resolution, and model selection, Joy's image generation capabilities simplify the creative process, allowing developers to focus on what matters most – bringing their ideas to life.

Prerequisites

To get started with Joy's Cognitive Actions, you'll need an API key and a basic understanding of how to make API calls.

Generate AI-Enhanced Images

The "Generate AI-Enhanced Images" action allows developers to create stunning images by utilizing AI-assisted techniques. This action addresses the need for high-quality image generation, offering flexibility in terms of model selection and output parameters.

Input Requirements

To use this action, you'll need to provide the following inputs:

  • prompt: A textual description of what you want the image to depict (e.g., "Create a whimsical 3D cartoon-style illustration of Dog, happy beagle in a cozy living room").
  • modelType: Choose between "dev" for optimal quality or "schnell" for faster results.
  • guidanceScale: A numerical value to control the level of guidance in the image generation process.
  • numberOfOutputs: Specify how many images to generate (between 1 and 4).
  • imageAspectRatio: Select the desired aspect ratio for the generated image.
  • imageOutputFormat: Choose the format for the output image (webp, jpg, png).
  • imageOutputQuality: Set the quality level of the generated images from 0 (lowest) to 100 (highest).
  • inferenceStepsCount: Determine the number of denoising steps to enhance image detail.

Expected Output

The action will return a URL linking to the generated image, allowing developers to easily integrate it into their applications.

Use Cases for this Action

  • Marketing Materials: Generate eye-catching visuals for advertisements or social media campaigns to attract more attention.
  • Game Development: Create unique character designs or environments that enhance the gaming experience.
  • Art Projects: Use the action to produce original artwork based on specific themes or concepts, perfect for portfolios or exhibitions.
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "3bafe83c-030f-4b19-a44e-c1c8dbe4411d" # Action ID for: Generate AI-Enhanced Images

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "prompt": "Create a whimsical 3D cartoon-style illustration of Dog, happy beagle in a cozy living room",
  "modelType": "dev",
  "guidanceScale": 3.5,
  "loraWeightScale": 1,
  "numberOfOutputs": 1,
  "imageAspectRatio": "1:1",
  "imageOutputFormat": "webp",
  "imageOutputQuality": 90,
  "imagePromptStrength": 0.8,
  "inferenceStepsCount": 28,
  "additionalLoraScaleWeight": 1
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    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 (non-JSON): {e.response.text}")
    print("------------------------------------------------")

Conclusion

Joy's Cognitive Actions empower developers to create stunning AI-enhanced images with ease. The flexibility in model selection and output parameters allows for a wide range of applications, from marketing to game development. As you explore these capabilities, think about how you can integrate them into your projects to elevate your visual content. Start experimenting with image generation today and unlock new creative possibilities!

← Back to All Articles