image-generation

Create Stunning Custom Images with Amz Driver

25 Apr 2025
Create Stunning Custom Images with Amz Driver

In the ever-evolving landscape of digital content, the ability to create customized images quickly and efficiently can make a significant difference for developers and businesses alike. The Amz Driver offers a powerful Cognitive Action to generate customized images using advanced inpainting techniques. This service allows you to specify various parameters such as image dimensions, aspect ratios, and masks, enabling you to tailor the output to your exact needs.

Whether you're looking to enhance marketing materials, create unique visual content for social media, or develop assets for applications, the Amz Driver streamlines the image creation process. With options for different image formats and fast execution modes, this tool simplifies image generation while delivering high-quality results.

Prerequisites

To get started with the Amz Driver, you'll need an API key for the Cognitive Actions service and a basic understanding of making API calls.

Generate Customized Image with Inpainting

This action enables you to create a customized image by utilizing inpainting techniques. It allows you to adjust various parameters, including image dimensions, aspect ratios, and masks, providing flexibility in the image generation process.

Input Requirements

The input for this action is a structured request that includes:

  • prompt: A detailed textual description of the image you want to generate.
  • mask (optional): An image mask for inpainting mode.
  • seed (optional): A random seed for reproducibility.
  • model: Choose between the "dev" or "schnell" model for image generation.
  • width and height: Specify dimensions if using a custom aspect ratio.
  • goFast: Optimize prediction speed.
  • imageFormat: Select from webp, jpg, or png for output.
  • outputCount: Define the number of images to generate (1-4).
  • imageQuality: Set the quality of the output image.
  • guidanceScale: Adjust the guidance for the diffusion process.
  • additional parameters: Such as Lora scales and denoising steps for finer control.

Expected Output

The expected output is one or more generated images based on the provided prompt and parameters, delivered in the specified format. For example:

[
  "https://assets.cognitiveactions.com/invocations/0a2c18a7-0f9a-404e-a099-0efd13188270/4b57f8cd-89c4-4cfe-9e46-98cefbd16079.webp",
  "https://assets.cognitiveactions.com/invocations/0a2c18a7-0f9a-404e-a099-0efd13188270/7986b782-9cff-4d57-b7d9-201adf2817b0.webp"
]

Use Cases for this Action

  • Marketing and Advertising: Create eye-catching visuals for campaigns that align with brand messaging.
  • E-commerce: Generate product images that feature specific attributes or settings to enhance customer engagement.
  • Social Media Content: Develop unique and tailored images for posts and stories that stand out in feeds.
  • Web and App Development: Provide custom graphics that fit the design requirements of applications and websites without the need for extensive graphic design skills.
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 = "a3df5262-2faa-404b-a3d9-0a549818cef3" # Action ID for: Generate Customized Image with Inpainting

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "model": "dev",
  "goFast": false,
  "prompt": "In a spacious warehouse setting, a man stands confidently in front of a sleek, modern delivery van. The van is painted in a metallic gray with a large, prominent \"Prime\" logo featuring the recognizable Amazon smile icon in blue. The van\\'s side door is open, revealing a well-organized interior with shelves and compartments, suggesting it is equipped for efficient package delivery. The man is wearing a high-visibility orange vest over a dark sweater and black pants, indicating he is likely a delivery driver or a warehouse worker. His arms are outstretched, possibly to emphasize the size or capacity of the van. The warehouse has a high ceiling with large windows, allowing natural light to flood the space, and there are other vehicles and equipment visible in the background. The overall scene conveys a sense of efficiency and readiness for delivery operations",
  "imageFormat": "webp",
  "outputCount": 2,
  "imageQuality": 80,
  "guidanceScale": 3,
  "mainLoraScale": 1,
  "denoisingSteps": 38,
  "imageAspectRatio": "16:9",
  "additionalLoraScale": 1,
  "imagePromptStrength": 0.88,
  "approximateMegapixels": "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

The Amz Driver's image generation capabilities offer developers a powerful tool to create customized images efficiently. With its extensive feature set, including customizable prompts, aspect ratios, and fast processing options, you can quickly generate high-quality visuals tailored to your specific needs. Whether for marketing, e-commerce, or application development, leveraging this technology can enhance your digital content strategy.

Start integrating the Amz Driver into your projects today and unlock the potential of tailored image creation.

← Back to All Articles