2026-09-26미디어 도구

AI 이미지 업스케일러 API: Sume로 이미지를 최대 4배 확대

POST /v1/image-upscale-1.0/upscale은 공개 HTTPS 이미지 URL과 upscale_factor 1–4(기본값 2)를 받아 PNG·JPG·WebP 중 하나를 반환합니다.

읽는 시간 4분Sume

Sume API로 이미지를 업스케일하려면 공개 HTTPS image_url을 POST /v1/image-upscale-1.0/upscale로 보내세요. 선택적으로 upscale_factor(1에서 4 사이, 기본값 2)와 output_format(png, jpg, webp 중 하나, 기본값 png)을 함께 보낼 수 있습니다. Sume Image Upscale 1.0(sume/image-upscale-1.0)이 이를 Job으로 실행하고 Sume 호스팅 이미지를 반환합니다.

Image Upscale 1.0은 Sume API 레퍼런스의 바탕이 되는 OpenAPI 문서에 명세되어 있습니다. Job, 아티팩트, 과금은 API 레퍼런스와 핵심 개념 문서 페이지를 따릅니다. 모두 2026-09-26에 확인한 내용입니다.

API로 이미지를 어떻게 업스케일하나요?

필수 필드는 image_url 하나뿐입니다. 모델은 Sume가 고르기 때문에 스키마에 모델 필드가 없으며, 표에 있는 필드 외에는 받지 않습니다. 같은 본문은 POST /v1/models/sume/image-upscale-1.0/runs에서도 동작합니다.

Sume API 레퍼런스의 Image Upscale 1.0 요청 필드, 2026-09-26 확인.
필드	허용 값	기본값
`image_url`	공개 HTTPS 이미지 URL(필수)	없음
`upscale_factor`	1에서 4 사이의 숫자	2
`output_format`	`png`, `jpg`, `webp` 중 하나	`png`
`mode`	`async`, `sync`, `subscribe`, `webhook` 중 하나	`async`
`wait_timeout_seconds`	`sync`나 `subscribe`의 블로킹 대기, 0–30초	명시되지 않음
`webhook_url`	공개 HTTPS 콜백 URL, 최대 2,048자	없음
`metadata`	Job 요청과 함께 저장되는 사용자 정의 객체	없음

curl -X POST https://api.sume.com/v1/image-upscale-1.0/upscale \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: upscale-hero-001" \
  -d '{
    "image_url": "https://example.com/images/hero.png",
    "upscale_factor": 4,
    "output_format": "webp",
    "mode": "async"
  }'

어떤 업스케일 배율과 출력 형식을 골라야 하나요?

배율은 출력이 입력보다 얼마나 커지는지를 정합니다. upscale_factor의 타입은 정수(integer)가 아니라 숫자(number)이며, 하한은 1, 상한은 4입니다. 생략하면 Sume는 2를 씁니다.

output_format은 결과의 파일 형식을 정합니다. jpg나 webp를 요청하지 않으면 png입니다. 각 결과 아티팩트는 content_type을 알려 주고 width와 height도 알려 줄 수 있으므로, 코드에서 무엇이 돌아왔는지 확인할 수 있습니다.

업스케일된 이미지는 어떻게 받나요?

모든 모드는 첫 응답에서 Job ID를 반환합니다. 기본값인 async에서는 GET /v1/jobs/:id/status로 Job을 폴링한 뒤 GET /v1/jobs/:id/result를 읽으세요. 이 엔드포인트는 공개 아티팩트 URL이 담긴 완료 페이로드를 반환합니다.

sync나 subscribe는 최대 wait_timeout_seconds(최댓값 30)만큼 블로킹합니다. Job이 아직 실행 중이면 응답은 현재 상태와 폴링 URL이 담긴 2xx입니다. 계속 폴링하고, 두 번째 유료 Job을 제출하지 마세요.
webhook은 즉시 반환되며, 종료 이벤트인 job.completed, job.failed, job.canceled만 전달하도록 콜백을 저장합니다. mode 없이 webhook_url을 보내면 webhook이 선택됩니다.
업스케일된 파일은 media.sume.com 아래의 Sume 호스팅 아티팩트입니다. URL 경로는 불투명한 값으로 다루세요.
요청이 클라이언트 쪽에서 타임아웃되면 Job ID를 보관했다가 Jobs API로 복구하세요. 폴링 패턴은 Job 상태를 폴링하는 방법을 참고하세요.

이미지 업스케일 비용은 얼마인가요?

API 요금에는 Image upscale이 이미지당 $0.20로 나와 있으며, 여기에 기본 5.5% 에이전트 수수료가 더해집니다. 요율표에는 이 항목이 이미지 업스케일 한 번이며 생성 출력 약 16메가픽셀 기준으로 예약된다고 설명되어 있고, 배율이나 형식별 요율은 따로 없습니다.

Sume는 제출할 때 예상 금액을 예약하고, 성공하면 확정하며, 확정 전에 실패하거나 취소된 Job은 환불합니다. 제출 응답은 예상 금액을 usage.billable_amount_usd로 알려 줍니다. 잔액이 이를 감당하지 못하면 제출은 402를 반환하고 Job은 시작되지 않습니다.

Image Upscale 1.0이 하지 않는 일은 무엇인가요?

Image Upscale 1.0은 이미 있는 이미지 한 장을 키웁니다. 이미지 생성은 별도 엔드포인트이며, 레퍼런스 이미지 기반 이미지 생성 API에서 다룹니다. 그 밖의 한계는 다음과 같습니다.

Job당 이미지 한 장: image_url은 URL 하나입니다.
upscale_factor는 4가 상한이고, output_format 값은 세 가지뿐입니다.
모델 선택 없음. 요청에서 모델 ID를 받지 않습니다.
입력은 가져올 수 있는 공개 HTTPS URL이어야 합니다. localhost, 사설 네트워크, HTTPS가 아닌 URL과 이미지가 아닌 응답은 생성 제출 전에 거부됩니다.
진행 상황 콜백 없음. 웹훅은 Job이 끝날 때만 발생합니다.

출처

작성자 Sume