
이미지 생성 및 편집 모델 생성 및 텍스트 또는 이미지 입력에서 이미지를 수정, inpainting, virtual try-on, style controls.
이미지 생성 및 편집 모델 생성 및 텍스트 또는 이미지 입력에서 이미지를 수정, inpainting, virtual try-on, style controls.
다른 이름 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 (white = 편집, black = keep). |
| 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에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.