2026-09-26미디어 도구

AI 영상 업스케일러 API: 배율, 향상 등급, 비용

POST /v1/video-upscale-1.0/upscale은 공개 HTTPS 영상 URL, scale_ratio 1.1–4, fast·standard·pro 중 하나의 향상 등급을 받습니다.

읽는 시간 5분Sume

Sume API로 영상을 업스케일하려면 공개 HTTPS video_url을 POST /v1/video-upscale-1.0/upscale로 보내면서 scale_ratio는 1.1에서 4 사이(기본값 2)로, enhancement_tier는 fast(기본값), standard, pro 중 하나로 지정하세요. Sume Video Upscale 1.0(sume/video-upscale-1.0)이 이를 Job으로 실행하고, duration_seconds 힌트를 기준으로 사용량을 예약하며, Sume 호스팅 영상을 반환합니다.

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

API로 영상을 어떻게 업스케일하나요?

필수 필드는 video_url 하나뿐입니다. 스키마에는 모델 필드가 없고, 표에 있는 필드 외에는 받지 않습니다. 같은 본문은 POST /v1/models/sume/video-upscale-1.0/runs에서도 동작합니다. 아래 예시는 mode 없이 웹훅 URL을 보내므로 webhook이 선택됩니다.

Sume API 레퍼런스의 Video Upscale 1.0 요청 필드, 2026-09-26 확인.
필드	허용 값	기본값
`video_url`	공개 HTTPS 영상 URL(필수)	없음
`scale_ratio`	1.1에서 4 사이의 숫자	2
`upscale_factor`	`scale_ratio`의 별칭, 1.1에서 4 사이. `scale_ratio`가 우선합니다.	2
`enhancement_tier`	`fast`, `standard`, `pro` 중 하나	`fast`
`duration_seconds`	예약 기준이 되는 입력 길이(초), 1에서 30 사이의 숫자	5초 예약
`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/video-upscale-1.0/upscale \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: upscale-clip-001" \
  -d '{
    "video_url": "https://example.com/videos/clip.mp4",
    "scale_ratio": 2,
    "enhancement_tier": "standard",
    "duration_seconds": 12,
    "webhook_url": "https://example.com/webhooks/sume"
  }'

배율과 향상 등급은 어떻게 설정하나요?

scale_ratio 또는 그 별칭인 upscale_factor를 보내세요. 둘 다 1.1에서 4 사이의 숫자를 받고 기본값은 2이며, 둘 다 보내면 scale_ratio가 우선합니다. 하한은 upscale_factor가 1부터 시작하는 Image Upscale 1.0과 다릅니다.

enhancement_tier는 이와 별개의 선택으로, fast, standard, pro 중 하나이며 기본값은 fast입니다. API 레퍼런스에는 이 세 값과 기본값만 나와 있고, API 요금에도 등급별 요율이 아니라 Video upscale 요율 하나만 나와 있습니다.

duration_seconds는 내는 금액에 어떤 영향을 주나요?

API 요금에는 Video upscale이 입력 클립 기준 영상 초당 $0.009로 나와 있으며, 여기에 기본 5.5% 에이전트 수수료가 더해집니다.

duration_seconds는 제출할 때 Sume가 예약 기준으로 삼는 입력 길이로, 1에서 30 사이입니다. 생략하면 Sume는 5초를 예약합니다. 요율표 가격으로 계산하면 이 기본 예약은 $0.045이고, 필드가 받는 최댓값인 30초는 $0.27이며, 둘 다 에이전트 수수료를 더하기 전 금액입니다.

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

업스케일된 영상은 어떻게 받나요?

모든 모드는 첫 응답에서 Job ID를 반환합니다. sync와 subscribe는 요청을 최대 30초 동안 붙잡아 두는데, 이 상한은 Job이 아니라 HTTP 대기 시간에 적용됩니다. 스키마는 새 연동에 async나 webhook을 권장합니다.

async: 폴링 사이에 최소 next_poll_after_seconds만큼 기다리면서 GET /v1/jobs/:id/status를 폴링한 뒤, GET /v1/jobs/:id/result에서 Sume 호스팅 영상을 읽으세요.
webhook: Sume는 콜백 URL을 저장하고 job.completed, job.failed, job.canceled만 전달합니다. 진행 상황 콜백은 없으므로 백업으로 폴링도 쓸 수 있게 해 두세요.
POST /v1/jobs/:id/cancel은 생성이 시작되기 전에만 Job을 멈춥니다. 그 뒤에는 409 job_generation_already_started를 반환합니다.

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

Video Upscale 1.0은 이미 있는 클립 하나를 키웁니다. 클립을 자르거나 크롭하거나 필터를 적용하는 일은 별도의 도구들이 맡으며, 영상 트림, 필터, 오디오 분리하기에서 다룹니다. 그 밖의 한계는 다음과 같습니다.

모델 선택 없음. 요청에서 모델 ID를 받지 않습니다.
scale_ratio와 upscale_factor는 4, duration_seconds는 30이 상한입니다.
Job당 영상 하나: video_url은 URL 하나입니다.
진행 상황 콜백 없음. 웹훅은 Job이 끝날 때만 발생합니다.

출처

작성자 Sume