인증

모든 요청에는 API 키가 필요하며, Bearer 토큰으로 전송합니다.

Authorization: Bearer vu_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API 사용 대상

API는 유료 계정, 즉 크레딧 팩을 구매했거나 구독한 계정을 위한 것입니다. 무료 계정은 API 키를 생성할 수 없으며, 한 번도 결제하지 않은 계정의 모든 요청은 403을 반환합니다.

{
  "error": {
    "code": "paid_plan_required",
    "message": "The API is available to accounts that have bought credits or subscribed. See https://videoupscaler.co/pricing"
  }
}

요금제 페이지에서 크레딧 팩을 하나라도 구매하면 이용할 수 있습니다. 크레딧을 모두 사용한 뒤에도 이용 권한은 유지되며, 이후에는 크레딧만 충전하면 됩니다.

키 발급

키는 설정 → API 키에서 생성합니다. 활성 키는 최대 20개까지 보유할 수 있으므로, 예를 들어 서버나 환경마다 하나씩 사용할 수 있습니다. 이 페이지에는 각 키의 이름, 앞뒤 일부 문자, 마지막 사용 시각이 표시됩니다.

전체 키는 생성할 때 단 한 번만 표시됩니다. 저희는 키의 해시만 저장하므로 다시 보여 드릴 수 없습니다. 키를 분실했다면 삭제하고 새로 생성하세요.

키 안전하게 관리하기

• 키를 사용하면 계정의 크레딧이 차감됩니다. 비밀번호처럼 다루세요.
• API는 서버에서 호출하세요. 브라우저, 모바일 앱, 공개 저장소에는 절대 키를 넣지 마세요.
• VIDEOUPSCALER_API_KEY 같은 환경 변수에서 키를 읽어 오세요.
• 키가 유출되었다면 설정에서 삭제하세요. 즉시 사용할 수 없게 됩니다.

오류

키가 없거나, 형식이 잘못되었거나, 삭제된 경우 401을 반환합니다.

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Send it as \"Authorization: Bearer vu_live_...\"."
  }
}