VideoUpscaler API

VideoUpscaler API로 직접 작성한 코드에서 동영상을 1080p, 2K 또는 4K로 업스케일합니다. 동영상 URL을 보내고, 작업 상태를 폴링한 뒤, 결과를 다운로드하세요. 웹사이트와 같은 크레딧을 사용하며 어떤 언어에서든 HTTPS로 호출할 수 있습니다.

VideoUpscaler API는 videoupscaler.co와 동일한 AI 동영상 업스케일러를 실행하며, 크레딧도 같은 잔액에서 차감됩니다. 모든 요청은 JSON 본문을 사용하는 일반 HTTPS 호출이므로 어떤 언어로든 사용할 수 있습니다.

Base URL: https://videoupscaler.co/api/v1

유료 계정 전용

API는 크레딧을 구매했거나 구독한 계정에서 사용할 수 있습니다. 요금제 페이지에서 크레딧 팩을 하나라도 구매하면 이용할 수 있으며, 무료 계정은 403 paid_plan_required를 받습니다.

작동 방식

  1. 동영상을 보냅니다. 공개된 video_url을 사용하거나, 먼저 파일을 업로드할 수 있습니다.
  2. 동영상 길이를 읽어 해당 크레딧을 차감하고 작업을 시작합니다.
  3. 작업이 completed가 될 때까지 폴링한 다음 output_url에서 결과를 다운로드합니다.

빠른 시작

API 키 생성

크레딧을 구매했거나 구독한 계정으로 로그인한 뒤 설정 → API 키를 엽니다. 키를 생성하고 복사해 두세요. 키는 생성 시 한 번만 표시됩니다. 키는 vu_live_… 형식입니다.

업스케일 시작

curl https://videoupscaler.co/api/v1/upscale \
  -H "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-video-001" \
  -d '{"video_url": "https://example.com/clip.mp4", "resolution": "4k"}'
const res = await fetch('https://videoupscaler.co/api/v1/upscale', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.VIDEOUPSCALER_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'my-video-001',
  },
  body: JSON.stringify({ video_url: 'https://example.com/clip.mp4', resolution: '4k' }),
});
const task = await res.json();
console.log(task.id, task.status);
import os, requests

res = requests.post(
    "https://videoupscaler.co/api/v1/upscale",
    headers={
        "Authorization": f"Bearer {os.environ['VIDEOUPSCALER_API_KEY']}",
        "Idempotency-Key": "my-video-001",
    },
    json={"video_url": "https://example.com/clip.mp4", "resolution": "4k"},
)
task = res.json()
print(task["id"], task["status"])

응답은 상태가 processing인 작업입니다.

완료될 때까지 폴링

curl https://videoupscaler.co/api/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VIDEOUPSCALER_API_KEY"

5–10초마다 폴링하거나, 대신 작업 이벤트를 스트리밍할 수 있습니다. status가 completed가 되면 output_url에서 동영상을 다운로드하세요. failed인 경우 크레딧은 환불되며, error에서 실패 원인을 확인할 수 있습니다.

엔드포인트

메서드경로설명
POST/upscale크레딧을 차감하고 동영상 업스케일 시작
POST/uploads로컬 파일 업로드용 서명된 URL 발급
GET/tasks/{id}작업 하나 조회
GET/tasks/{id}/events상태 변경 스트리밍(Server-Sent Events)
GET/tasks작업 목록을 최신순으로 조회
GET/account크레딧 잔액 및 요금

AI 어시스턴트로 작업하고 싶으신가요? MCP 서버를 Claude Code, Cursor 또는 VS Code에 연결하세요.