Nova Canvas
Generate images via Amazon Nova Canvas on AWS Bedrock.
AWS Auth Methods
| Method | How to Use |
|---|
| Bearer token | INLINECODE0 env var or INLINECODE1 |
| Environment variables |
Set
AWS_ACCESS_KEY_ID +
AWS_SECRET_ACCESS_KEY |
|
Credentials file | Configure
~/.aws/credentials |
|
Named profile |
--profile my-profile or
AWS_PROFILE env var |
|
Direct keys |
--access-key AKIA... --secret-key ... |
|
Temporary credentials | Add
--session-token with direct keys |
|
IAM instance role | Auto-detected on EC2/ECS/Lambda |
|
AWS SSO | Run
aws sso login first |
Auto-detection order: direct keys → profile → bearer token → env vars → credentials file → instance role → SSO.
Quick Start
CODEBLOCK0
Parameters
| Flag | Default | Description |
|---|
| INLINECODE10 | — | Text description of the image |
| INLINECODE11 |
output.png | Output file path |
|
-W, --width | 1024 | Width 512-4096, divisible by 64 |
|
-H, --height | 1024 | Height 512-4096, divisible by 64 |
|
-n, --count | 1 | Number of images (1-5) |
|
-q, --quality | standard |
standard or
premium |
|
-s, --seed | random | Seed for reproducibility |
|
--negative | — | Negative prompt (what to avoid) |
|
--cfg | 8.0 | CFG scale 1.1-10.0 |
|
--region | us-east-1 | AWS 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).
- Choose size: square 1024×1024, landscape 1280×768, portrait 768×1280.
- Run
generate.py with timeout=120. - 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.
Nova Canvas
通过Amazon Nova Canvas在AWS Bedrock上生成图像。
AWS认证方式
| 方法 | 使用方式 |
|---|
| Bearer令牌 | AWSBEARERTOKENBEDROCK环境变量或--bearer-token |
| 环境变量 |
设置AWSACCESS
KEYID + AWS
SECRETACCESS_KEY |
|
凭据文件 | 配置~/.aws/credentials |
|
命名配置文件 | --profile my-profile或AWS_PROFILE环境变量 |
|
直接密钥 | --access-key AKIA... --secret-key ... |
|
临时凭据 | 配合直接密钥添加--session-token |
|
IAM实例角色 | 在EC2/ECS/Lambda上自动检测 |
|
AWS SSO | 先运行aws sso login |
自动检测顺序：直接密钥 → 配置文件 → Bearer令牌 → 环境变量 → 凭据文件 → 实例角色 → SSO。
快速开始
bash
python3 {baseDir}/scripts/generate.py 你的提示词 -o output.png
python3 {baseDir}/scripts/generate.py 你的提示词 -o output.png --profile work
python3 {baseDir}/scripts/generate.py 你的提示词 -o output.png --access-key AKIA... --secret-key ...
参数
| 标志 | 默认值 | 描述 |
|---|
| prompt | — | 图像的文本描述 |
| -o, --output |
output.png | 输出文件路径 |
| -W, --width | 1024 | 宽度512-4096，需能被64整除 |
| -H, --height | 1024 | 高度512-4096，需能被64整除 |
| -n, --count | 1 | 图像数量（1-5） |
| -q, --quality | standard | standard或premium |
| -s, --seed | 随机 | 用于可复现性的种子值 |
| --negative | — | 负面提示词（要避免的内容） |
| --cfg | 8.0 | CFG比例1.1-10.0 |
| --region | us-east-1 | AWS区域 |
| --profile | — | AWS命名配置文件 |
| --access-key | — | AWS访问密钥ID |
| --secret-key | — | AWS秘密访问密钥 |
| --session-token | — | AWS会话令牌 |
| --bearer-token | — | Bearer令牌（覆盖环境变量） |
工作流程
- 1. 编写详细的英文提示词（Nova Canvas在英文环境下表现最佳）。
- 选择尺寸：正方形1024×1024，横屏1280×768，竖屏768×1280。
- 运行generate.py，设置timeout=120。
- 通过message工具将生成的图像发送给用户。
提示词技巧
- - 详细的英文提示词可获得最佳效果。
- 指定风格：油画、水彩、3D渲染、照片、动漫。
- 使用--negative 模糊, 低质量, 文字, 水印排除不需要的元素。
