동작 방식
비디오 업스케일링은 비디오 생성과 같은 비동기 큐 시스템을 사용합니다:- 큐 —
topaz-video-upscale모델과 함께 비디오를/video/queue에 제출 - 폴링 — 반환된
queue_id로/video/retrieve를 호출해 상태가completed가 될 때까지 확인 - 완료 —
/video/complete를 호출해 마무리하고 출력 URL을 받음
업스케일 배수
upscale_factor 파라미터는 업스케일 모델에서 resolution을 대체합니다. resolution을 전달하면 에러를 반환합니다. 이는 출력 해상도가 input 비디오의 크기에 따라 다르기 때문입니다 — 720p 비디오의 2x 업스케일과 480p 비디오의 2x 업스케일은 다른 결과를 만듭니다.지원 input 포맷
- 포맷: MP4, MOV, WebM
- Input 방식: HTTPS URL 또는
data:video/...;base64,...data URL - 최대 길이: 300초(5분)
API 사용법
업스케일 작업 큐 등록
queue_id가 포함됩니다:
완료 폴링
complete로 마무리
결과를 retrieve한 후/video/complete를 호출해 마무리하세요:
API 파라미터
업스케일 모델에서 사용하지 않는 파라미터
다음 파라미터는topaz-video-upscale에서 허용되지 않으며 제공하면 에러를 반환합니다:
duration 파라미터도 무시됩니다 — 서버는 과금 정확성을 위해 비디오 파일에서 직접 길이를 감지합니다.
가격
가격은 길이, 출력 해상도 등급, 프레임 속도를 기반으로 합니다. 출력 해상도 등급은 input 비디오 높이에 업스케일 배수를 곱한 값으로 결정됩니다.출력 해상도 등급
48fps를 초과하는 프레임 속도의 비디오는 초당 요율의 2배입니다.
가격 예시
작업 제출 전 정확한 가격을 받으려면 Video Quote API를 사용하세요.
견적 받기
input_height를 받습니다. 선택 사항입니다 — 생략하면 견적이 보수적인 추정을 가정합니다.