소개
Gigapixel 확대
Gigapixel은 정밀 확대와 생성형 재구성을 제공합니다. 프리셋을 생략하면 standard_v2를 사용합니다.
요청 설정
image_url을 전달하고 resolution을 2k, 4k, 8k 중에서 선택합니다. 기본 해상도는 4k, 기본 형식은 JPEG입니다.
출력 제약
투명 소재에는 preset: transparent와 output_format: png를 함께 지정하고 출력 가장자리를 확인합니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 입력 형식 | JPEG, PNG, WebP |
| 기본 프리셋 |
|
| 기본 단계 | 4K |
| 출력 형식 | JPEG 또는 PNG, 투명 모델은 항상 PNG |
| 과금 기준 | 프리셋과 출력 단계별 이미지 단위 |
핵심 기능 및 하이라이트
픽셀을 늘려도 흐린 눈이 저절로 선명해지지는 않습니다
왼쪽부터 입력, Standard V2, Wonder 4를 배치합니다. Standard는 흐림까지 확대하며, Wonder는 이번 시험에서 전체적인 인상을 유지하면서 눈과 얼굴을 더 또렷하게 재구성합니다.
선명도와 함께 얼굴의 변화도 확인합니다
Redefine 결과에서는 남성이 더 젊어 보이며 이목구비도 달라집니다. Recover 3와 Standard MAX도 세부 묘사를 재구성하고, Detail은 이번의 심한 흐림을 더 많이 남깁니다. 한 장의 이미지에서 관찰한 결과를 설명합니다.
장미를 확대해도 배경 투명도를 보존합니다
배경을 제거한 노란 주황빛 장미의 PNG를 400×301에서 2360×1776으로 확대하면서 알파 채널을 유지합니다. 분홍색 꽃잎 끝의 물방울과 짧은 초록색 줄기, 잎을 확인할 수 있습니다. 비교의 어두운 배경은 표시 용도로만 사용하며, 예제 파일은 투명도를 유지합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | Gigapixel로 확대할 JPEG, PNG, WebP 한 장을 지정합니다. 1자 이상 |
preset | 아니요 | 정밀 5종, 생성형 6종, 투명 PNG용 |
resolution | 아니요 |
|
output_format | 아니요 | 기본 |
요금
Gigapixel은 처리 이미지마다 preset과 resolution에 따라 과금합니다. output_format 변경은 요금에 영향을 주지 않습니다.
| 해상도 | 스타일 프리셋: cgi | 스타일 프리셋: detail | 스타일 프리셋: high_fidelity_v3 | 스타일 프리셋: low_resolution_v2 | 스타일 프리셋: standard_v2 | 스타일 프리셋: text_refine | 스타일 프리셋: transparent | 스타일 프리셋: wonder_3_5 | 스타일 프리셋: wonder_4 | 스타일 프리셋: recover_3 | 스타일 프리셋: redefine | 스타일 프리셋: standard_max |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.24 / 장 | $0.24 / 장 | $0.24 / 장 |
| $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.12 / 장 | $0.36 / 장 | $0.36 / 장 | $0.60 / 장 | $0.60 / 장 | $0.60 / 장 |
| $0.36 / 장 | $0.36 / 장 | $0.36 / 장 | $0.36 / 장 | $0.36 / 장 | $0.36 / 장 | $0.36 / 장 | $1.08 / 장 | $1.08 / 장 | $2.04 / 장 | $2.04 / 장 | $2.04 / 장 |
활용 사례
AI 이미지 인쇄 준비
출력 단계를 정한 뒤 얼굴과 미세한 무늬를 확인하고 인쇄합니다.
로고와 투명 소재 확대
글자와 그래픽에는 text_refine, 배경 투명도를 유지할 PNG에는 transparent를 선택합니다.
프롬프트 가이드 및 실전 팁
원본 지정
사진이나 그림의 JPEG, PNG, WebP를
image_url로 전달합니다.재구성 범위 결정
내용을 유지하는 확대에는
standard_v2, 잃은 세부 묘사 재구성에는wonder_4등을 선택합니다.출력 설정
resolution과 형식을 정하고,transparent에는output_format: png를 명시합니다.
Gigapixel 확대
Gigapixel 프리셋으로 사진이나 그래픽을 선택한 픽셀 단계까지 확대하며, 투명 이미지에는 PNG를 반환합니다.
요청 설정
{
"image_url": "https://example.com/blurred-portrait.jpg",
"preset": "standard_v2",
"resolution": "2k",
"output_format": "jpeg"
}
프리셋 안내
preset | 적합한 용도 |
|---|---|
standard_v2 | 일반 사진용 기본 정밀 모델입니다 |
high_fidelity_v3 | 이미 선명한 고해상도 소재에 사용합니다 |
low_resolution_v2 | 작거나 압축이 심한 이미지에 사용합니다 |
cgi | 일러스트와 렌더링에 사용합니다 |
text_refine | 글자, 로고, 그래픽에 사용합니다 |
wonder_4 | 최신 범용 생성형 확대 모델입니다 |
wonder_3_5 | Wonder 3.5로 세부 묘사를 재구성합니다 |
recover_3 | 심하게 손상된 사진에 사용합니다 |
standard_max | 세부 묘사를 생성하여 재구성합니다 |
redefine | 새로운 묘사를 추가하며 인상을 바꿀 수 있습니다 |
detail | AI 얼굴의 피부를 더 사실적으로 표현합니다 |
transparent | PNG를 알파 채널과 함께 확대합니다 |
실측 결과
왼쪽부터 입력, Standard V2, Wonder 4를 배치합니다. Standard는 흐림까지 확대하며, Wonder는 이번 시험에서 전체적인 인상을 유지하면서 눈과 얼굴을 더 또렷하게 재구성합니다.
Redefine 결과에서는 남성이 더 젊어 보이며 이목구비도 달라집니다. Recover 3와 Standard MAX도 세부 묘사를 재구성하고, Detail은 이번의 심한 흐림을 더 많이 남깁니다. 한 장의 이미지에서 관찰한 결과를 설명합니다.
배경을 제거한 노란 주황빛 장미의 PNG를 400×301에서 2360×1776으로 확대하면서 알파 채널을 유지합니다. 분홍색 꽃잎 끝의 물방울과 짧은 초록색 줄기, 잎을 확인할 수 있습니다. 비교의 어두운 배경은 표시 용도로만 사용하며, 예제 파일은 투명도를 유지합니다.
출력 제약
요청 하나에서 이미지 한 장에 프리셋 하나를 적용합니다. 생성형 모델은 얼굴과 세부 묘사를 바꿀 수 있어 신분증이나 증거 자료 복원에는 부적합합니다. 8K 파일은 용량이 커질 수 있습니다. transparent와 JPEG의 조합은 거부합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "topaz/gigapixel/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "standard_v2",
"resolution": "4k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
