画像生成と編集モデルは、テキストや画像入力から画像を作成および変更し、インペレーション、バーチャルトライオン、スタイル制御を行います。
Amazon画像生成リリース 2024年12月3日独自エンドポイント画像生成と編集モデルは、テキストや画像入力から画像を作成および変更し、インペレーション、バーチャルトライオン、スタイル制御を行います。
別名 Amazon-Nova-Canvas
amazon-nova-canvas/v1/images/generationsamazon.nova-canvas-v1:0amazon/nova-canvasnova-canvasEmpirioLabs カタログのライブ従量課金料金です。使った分だけの支払いで、月額最低料金はありません。
Amazon Nova Canvas は POST /v1/images/generations で動作します。リクエストはすぐに job_id を返すので、ジョブが完了するまで GET /v1/jobs/{job_id} をポーリングし、結果から出力 URL を読み取ってください。 また、"sync": true を追加するとポーリングを省略できます。リクエストは開いたまま OpenAI 形式の完成した画像レスポンスを直接返すため、OpenAI SDK がそのまま動作します。 EmpirioLabs ダッシュボードで API キーを取得してください。
curl https://api.empiriolabs.ai/v1/images/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "amazon-nova-canvas",
"prompt": "Describe what you want Amazon Nova Canvas to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/images/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "amazon-nova-canvas",
"prompt": "Describe what you want Amazon Nova Canvas to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs 上の Amazon Nova Canvas API が対応するリクエストパラメーターです。フィールドを省略した場合はデフォルト値が適用されます。
| パラメータ | タイプ | デフォルト | 範囲 / 値 | 説明 |
|---|---|---|---|---|
| prompt | string | - | - | 生成する画像のテキスト説明。 |
| task_type | enum | TEXT_IMAGE | TEXT_IMAGE, IMAGE_VARIATION, INPAINTING, OUTPAINTING, BACKGRO... | TEXT_IMAGE |インペインティング |アウトペインティング |IMAGE_VARIATION |COLOR_GUIDED_GENERATION |BACKGROUND_REMOVAL |VIRTUAL_TRY_ON。 |
| quality | enum | standard | standard, premium | 標準|プレミアム。プレミアムは遅いですが、忠実度は高いです。 |
| negative_prompt | string | - | - | 画像で避けるべき点のテキスト説明。 |
| number_of_images | number | 1 | 1 から 5 | 生成する画像の数(1〜5枚)はどうでしょうか。 |
| aspect_ratio | enum | 1:1 | 1:1, 3:4, 2:3, 9:16, 1:2, 1:3, 1:4, 4:3, 3:2, 16:9, 2:1, 3:1,... | 出力アスペクト比(1:1、16:9、9:16、4:3、3:2など)。 |
| size_scale | enum | small | small, large | 出力解像度のスケール。高いほど=大きな画像、より遅い生成。 |
| cfg_scale | number | 7.5 | 1 から 20 | 迅速な遵守(1.1-10)。高い方が=プロンプトに近いが創造性は低いです。 |
| seed | number | - | - | 再現性のためのランダムシード。同じシード+プロンプト=同じ出力。 |
| image | string | - | - | インペインティング/アウトペインティング/バリエーション作業用のソース画像(URLまたはbase64)。 |
| reference_image | string | - | - | スタイルや内容のマッチングのための参考画像。 |
| mask_image | string | - | - | 編集する領域を定義するマスクBlack/white(白=編集、黒=保持)。 |
| mask_prompt | string | - | - | インペインティングのためにマスキングするための自然言語による地域の記述。 |
| inpaint_mask_prompt | string | - | - | mask_promptと同様に、特にインペインティング作業に関しては。 |
タスクタイプ - TEXT_IMAGE - IMAGE_VARIATION - インペインティング - アウトペインティング - BACKGROUND_REMOVAL - COLOR_GUIDED_GENERATION - VIRTUAL_TRY_ON マスク - 画像ベースまたはtext-prompt-based コンテンツ安全性 - 生成された画像は自動コンテンツ安全チェックに合格します。過激な画像は返送されません。画像はチェック実行前に生成されるため、フラグ付きの生成は請求されます。
EmpirioLabs では Amazon Nova Canvas は従量課金です: 小さい標準(≤1024×1024) $0.12 イメージ; 小さい報酬(≤1024×1024) $0.18 イメージ; 大きい標準(≤2048×2048) $0.18 イメージ。このページのライブ料金表は常に API の請求額と一致します。
Amazon Nova Canvas は api.empiriolabs.ai 上の POST /v1/images/generations で提供され、標準的な Bearer トークン認証を使用します。
はい。EmpirioLabs プレイグラウンドでは API と同じパラメーターで Amazon Nova Canvas をブラウザ上で実行できるので、コードを書く前にプロンプトを試せます。
EmpirioLabs アカウントを作成し、ダッシュボードの API Keysでキーを生成してください。課金は従量制クレジットなので、実行したリクエストの分だけ支払います。
