소개
이 엔드포인트가 하는 일
이미지 1장을 받아 고른 크기 단계에서 더 크고 선명한 사본을 돌려줍니다. 구도, 색, 피사체는 보낸 그대로이며 프롬프트는 없습니다.
중요한 입력
image_url은 키울 이미지입니다. resolution으로 크기 단계를 고릅니다. 2k(약 400만 화소), 4k(약 1,700만 화소, 기본값), 8k(약 6,700만 화소)입니다. 화면비는 유지되고, 원본보다 작은 단계를 고르면 축소됩니다. output_format은 파일 형식이며 jpeg(기본값), png, webp 중에서 고릅니다.
돌려받는 것
요청 1건에 이미지 1장이 작업 완료 후 플랫폼 스토리지에서 제공됩니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | 업스케일 |
| 크기 단계 | 2K(약 4MP), 4K(약 17MP), 8K(약 67MP) |
| 화면비 | 원본 그대로 |
| 조절 항목 | 프롬프트 없음. 크기 단계와 파일 형식만 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 이미지 파일로 바로 연결되는 링크(JPEG, PNG, WebP)입니다. 구도와 화면비는 그대로 이어집니다. 1자 이상 |
resolution | 아니요 | 2k(약 4MP), 4k(약 17MP, 기본값), 8k(약 67MP)이며 화면비는 유지됩니다. 원본 픽셀 수보다 큰 단계를 고르십시오. |
output_format | 아니요 | 기본값인 jpeg는 파일을 다루기 쉽게 유지하며 테스트에서 가장 큰 단계도 약 8MB였습니다. png는 무손실이지만 몇 배 크고, webp는 그 중간입니다. |
요금
$0.012 / 장
출력 이미지 1장당 과금합니다. 크기 단계와 파일 형식은 요금에 영향을 주지 않습니다.
활용 사례
AI 생성 이미지를 인쇄 크기로
대부분의 이미지 모델은 100만에서 200만 화소 정도를 돌려줍니다. 4k나 8k로 키우면 마음에 든 결과를 다시 생성하지 않고도 포스터나 인쇄 크기로 쓸 수 있습니다.
제품 사진과 카탈로그
확대 보기와 고해상도 상품 페이지에 맞게 제품 사진을 키우면서 조명과 라벨은 촬영한 그대로 유지합니다.
작은 이미지를 새 레이아웃에
썸네일, 웹용 크기의 사진, 오래된 소재를 히어로 배너나 슬라이드가 요구하는 크기까지 끌어올립니다.
프롬프트 가이드 및 실전 팁
원본 크기 확인
지금 이미지의 픽셀 수보다 큰 단계를 고르십시오. 작은 단계를 고르면 축소됩니다. 이후 작업이 큰 파일을 다루지 않도록 업스케일은 모든 편집을 마친 뒤에 합니다.
image_url과 resolution 보내기
image_url은 대상 이미지이고 resolution으로 2k, 4k(기본값), 8k를 고릅니다. jpeg 대신 png나 webp가 필요할 때만 output_format을 추가합니다.
폴링 후 다운로드
호출은 비동기입니다. 작업을 만들고 끝날 때까지 폴링한 뒤 플랫폼 스토리지에서 파일을 받습니다. 8k jpeg는 약 8MB이므로 다운로드 시간을 고려하십시오.
소개
Image Upscaler는 완성된 이미지 1장을 2k, 4k, 8k 크기 단계까지 키우면서 선명하게 다듬습니다. 그림 자체는 바뀌지 않으며 구도, 색, 피사체는 보낸 그대로 남습니다. 프롬프트는 없고 조절할 것은 크기와 파일 형식뿐입니다.
요청
{
"image_url": "https://example.com/product.png",
"resolution": "4k",
"output_format": "jpeg"
}
필수 항목은 image_url뿐입니다. resolution의 기본값은 4k, output_format의 기본값은 jpeg입니다.
크기 단계의 동작
단계는 고정된 캔버스가 아니라 픽셀 수의 기준이며 화면비는 항상 유지됩니다. 1024×1536 사진은 2k에서 1672×2508, 4k에서 3344×5017, 8k에서 6689×10033이 되었고 모두 약 45초가 걸렸습니다. 이미 단계보다 큰 원본은 축소됩니다. 3344×5017 이미지를 2k로 보내자 1672×2509로 돌아왔습니다.
작업 흐름
호출은 비동기입니다. 작업을 만들고 종료 상태가 될 때까지 폴링한 다음 플랫폼 스토리지에서 이미지를 받습니다. 요청 1건에 이미지 1장이 돌아옵니다.
팁
- 원본 픽셀 수보다 큰 단계를 고르십시오.
- 이후 작업이 큰 파일을 처리하지 않도록 업스케일은 모든 편집을 마친 뒤에 하십시오.
- 가장 깨끗한 원본에서 시작하십시오. 압축 노이즈와 흔들림도 함께 커집니다.
- 무손실 출력이 필요하지 않다면
jpeg를 쓰십시오. 8k jpeg는 약 8MB였고png는 그 몇 배입니다.
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": "spicyapi/image-upscaler-v1/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"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 레퍼런스에서 확인하세요.
