generate_image_with_colors
Create images from text prompts with specific color palettes using Amazon Nova Canvas. Generate visuals for mockups, diagrams, and design concepts by providing descriptive text and hexadecimal color values.
Instructions
Generate an image using Amazon Nova Canvas with color guidance.
This tool uses Amazon Nova Canvas to generate images based on a text prompt and color palette.
The generated image will be saved to a file and the path will be returned.
IMPORTANT FOR Assistant: Always send the current workspace directory when calling this tool!
The workspace_dir parameter should be set to the directory where the user is currently working
so that images are saved to a location accessible to the user.
## Prompt Best Practices
An effective prompt often includes short descriptions of:
1. The subject
2. The environment
3. (optional) The position or pose of the subject
4. (optional) Lighting description
5. (optional) Camera position/framing
6. (optional) The visual style or medium ("photo", "illustration", "painting", etc.)
Do not use negation words like "no", "not", "without" in your prompt. Instead, use the
negative_prompt parameter to specify what you don't want in the image.
## Example Colors
- ["#FF5733", "#33FF57", "#3357FF"] - A vibrant color scheme with red, green, and blue
- ["#000000", "#FFFFFF"] - A high contrast black and white scheme
- ["#FFD700", "#B87333"] - A gold and bronze color scheme
Returns:
McpImageGenerationResponse: A response containing the generated image paths.Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | The text description of the image to generate (1-1024 characters) | |
| colors | Yes | List of up to 10 hexadecimal color values (e.g., "#FF9800") | |
| negative_prompt | No | Text to define what not to include in the image (1-1024 characters) | |
| filename | No | The name of the file to save the image to (without extension) | |
| width | No | The width of the generated image (320-4096, divisible by 16) | |
| height | No | The height of the generated image (320-4096, divisible by 16) | |
| quality | No | The quality of the generated image ("standard" or "premium") | standard |
| cfg_scale | No | How strongly the image adheres to the prompt (1.1-10.0) | |
| seed | No | Seed for generation (0-858,993,459) | |
| number_of_images | No | The number of images to generate (1-5) | |
| workspace_dir | No | The current workspace directory where the image should be saved. CRITICAL: Assistant must always provide this parameter to save images to the user's current project. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paths | Yes | ||
| status | Yes |