Nova Canvas#

Generate images via Amazon Nova Canvas on AWS Bedrock.

AWS Auth Methods#

MethodHow to UseBearer tokenAWS_BEARER_TOKEN_BEDROCK env var or --bearer-tokenEnvironment variablesSet AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEYCredentials fileConfigure ~/.aws/credentialsNamed profile--profile my-profile or AWS_PROFILE env varDirect keys--access-key AKIA... --secret-key ...Temporary credentialsAdd --session-token with direct keysIAM instance roleAuto-detected on EC2/ECS/LambdaAWS SSORun aws sso login first

Auto-detection order: direct keys → profile → bearer token → env vars → credentials file → instance role → SSO.

Quick Start#

bash

python3 {baseDir}/scripts/generate.py "your prompt" -o output.png
python3 {baseDir}/scripts/generate.py "your prompt" -o output.png --profile work
python3 {baseDir}/scripts/generate.py "your prompt" -o output.png --access-key AKIA... --secret-key ...

Parameters#

FlagDefaultDescriptionprompt—Text description of the image-o, --outputoutput.pngOutput file path-W, --width1024Width 512-4096, divisible by 64-H, --height1024Height 512-4096, divisible by 64-n, --count1Number of images (1-5)-q, --qualitystandardstandard or premium``-s, --seedrandomSeed for reproducibility--negative—Negative prompt (what to avoid)--cfg8.0CFG scale 1.1-10.0--regionus-east-1AWS region--profile—AWS named profile--access-key—AWS Access Key ID--secret-key—AWS Secret Access Key--session-token—AWS Session Token--bearer-token—Bearer token (overrides env)

Workflow#

1. Craft a detailed English prompt (Nova Canvas performs best in English).
2. Choose size: square 1024×1024, landscape 1280×768, portrait 768×1280.
3. Run generate.py with timeout=120.
4. Send resulting image to user via message tool.

Prompt Tips#

• Detailed English prompts yield best results.
• Specify style: "oil painting", "watercolor", "3D render", "photograph", "anime".
• Use --negative "blurry, low quality, text, watermark" to exclude unwanted elements.