요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 720p · 1080p · 2k · 4k · 기본값: 1080p |
video_url | 예 | 작업할 영상. |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /초 | ≈ USD |
|---|---|---|
| resolution 1080p | 0.9 | US$0.009 |
| resolution 720p | 0.9 | US$0.009 |
| resolution 2K | 1.8 | US$0.018 |
| resolution 4K | 3.6 | US$0.036 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Video Upscaler API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/video-upscaler-v1/upscale, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/video-upscaler-v1/upscale",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"resolution": "1080p"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Video Upscaler API 질문
Video Upscaler API 요금은 얼마인가요?
Video Upscaler 가격은 0.9크레딧(US$0.009) /초입니다. 옵션별 가격: 1080p 0.9크레딧/초, 720p 0.9크레딧/초, 2K 1.8크레딧/초, 4K 3.6크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Video Upscaler의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 영상 화질 개선: popnow/video-upscaler-v1/upscale을(를) 넣으세요.
오디오와 타이밍이 유지됩니까?
유지됩니다. AAC 오디오가 있는 854×480 클립이 같은 오디오 트랙과 함께 1922×1080으로 돌아왔고, 모든 테스트에서 재생 길이는 원본과 프레임 단위까지 일치했습니다.
1080p인데 왜 정확히 1920×1080이 아닙니까?
단계는 픽셀 수의 기준이고 클립의 화면비가 유지되기 때문입니다. 832×480 클립은 1080p에서 1896×1094, 4K에서 3792×2188이 되었습니다. 세로 클립은 세로 그대로 돌아옵니다.
움직임이나 화면 속 내용이 바뀝니까?
바뀌지 않습니다. 해상도만 올리는 단계이므로 구도, 움직임, 컷, 타이밍은 보낸 그대로입니다. 내용을 바꾸려면 먼저 편집하거나 다시 생성하고 업스케일은 마지막에 하십시오.
Video Upscaler API의 제한은 무엇인가요?
해상도: 720p · 1080p · 2K · 4K. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Video Upscaler을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Video Upscaler을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

