image-generation

Create Stunning Images with Guyzoa's Customizable Image Generation

26 Apr 2025
Create Stunning Images with Guyzoa's Customizable Image Generation

In the evolving landscape of artificial intelligence, creating unique and visually appealing images has never been easier. With Guyzoa's Cognitive Actions, developers can harness the power of customizable image generation to create images tailored to specific needs and parameters. This service allows you to generate images using a variety of inputs, enabling a level of creativity and personalization that can significantly enhance user experiences. Whether you're developing a game, designing a marketing campaign, or creating digital art, Guyzoa's image generation capabilities provide a fast and efficient way to produce stunning visuals.

Prerequisites

To get started with Guyzoa's Cognitive Actions, you'll need an API key for authentication and a basic understanding of making API calls.

Generate Image with Parameters

The "Generate Image with Parameters" action is designed to create images based on customizable parameters, including model type, image mask, dimensions, and more. This action is particularly useful for developers looking to implement image-to-image transformations or inpainting, providing optimized results with models like 'dev' and 'schnell'.

Purpose

This action solves the challenge of generating high-quality images that meet specific design requirements. By allowing for custom input parameters, developers can fine-tune the output to align with their creative vision.

Input Requirements

The input schema for this action includes several fields that must be specified:

  • prompt: The text prompt guiding the generation (mandatory).
  • mask: An optional URI for an image mask used in inpainting.
  • image: An optional URI for an input image when using image-to-image transformation.
  • width and height: Dimensions for the generated image, applicable if a custom aspect ratio is set.
  • aspectRatio: Defines the image's aspect ratio, with options for predefined ratios and a custom setting.
  • numOutputs: The number of images to generate.
  • Additional parameters like guidanceScale, outputQuality, and inferenceModel further control the image quality and generation process.

Expected Output

The output will be a URI link to the generated image, allowing developers to easily access and utilize the created content.

Use Cases for this Action

  1. Game Development: Create unique character images or environments based on specific prompts, enhancing the visual appeal of games.
  2. Marketing: Generate bespoke images for advertising campaigns that align with brand aesthetics and messaging.
  3. Digital Art: Artists can use this action to explore new styles and concepts by inputting various prompts and parameters.
  4. Content Creation: Bloggers and content creators can produce custom images that complement their articles or videos, making their content more engaging.
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 = "ef8786f0-f491-4281-b71c-b4fe38798ea1" # Action ID for: Generate Image with Parameters

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "goFast": false,
  "prompt": "guyzoa  man, looking to the camera",
  "loraScale": 1,
  "numOutputs": 1,
  "aspectRatio": "16:9",
  "outputFormat": "jpg",
  "guidanceScale": 3,
  "outputQuality": 80,
  "extraLoraScale": 1,
  "inferenceModel": "dev",
  "promptStrength": 0.8,
  "imageMegapixels": "1",
  "numInferenceSteps": 28
}

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

Guyzoa's customizable image generation offers a powerful tool for developers looking to create unique and tailored visuals efficiently. With its wide range of parameters, you can generate images that fit various applications, from gaming to marketing. As you explore the potential of this action, consider the various scenarios where personalized imagery could enhance user experiences, and take the next steps in integrating Guyzoa into your projects.

← Back to All Articles