GuidesAPI GuideChangelog
Log In
API Guide

클립 영상 및 이미지 업로드 URL 발행

2026-05-20 버전의 클립 영상 및 이미지 업로드 URL 발행 API입니다.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

파일 업로드 준비 - API 요청 시 업로드할 파일의 MIME 타입을 함께 전달해야 합니다.

  • 비디오의 MIME 타입 - video/mp4 (필수사항으로 따로 타입을 보내지 않아도됩니다.)
  • 채널 로고 / 썸네일 허용 MIME 타입- image/jpeg,image/png
  • 채널 로고 / 썸네일 허용 MIME 타입- image/jpeg,image/png

응답 객체 구조

  • 요청 성공 시 아래 세 가지 객체가 반환됩니다.
객체명필수여부설명
clipSource필수클립 영상 업로드 정보
thumbnail선택썸네일 이미지 업로드 정보
channelLogo선택채널 로고 이미지 업로드 정보

  • 각 객체는 공통적으로 두 가지 필드를 포함합니다.
객체명설명
fileName**클립 영상 및 이미지 업로드 ** 요청 시 사용할 파일명
uploadUrl파일을 S3에 직접 업로드하기 위한 Pre-signed URL

파일 업로드 방법

  1. 응답에서 uploadUrl을 추출합니다.
  2. **클립 영상 및 이미지 업로드 ** 을 참고하여 HTTP PUT 요청을 보내 파일을 S3에 업로드합니다.
  3. 업로드 완료 후, fileName 값을 클립 영상 업로드 API 요청에 포함합니다.
Body Params
string

업로드할 클립영상의 썸네일의 contentType(가능한 값image/jpeg, image/png)
해당 값을 넣지 않으면 기본 썸네일을 사용하게됩니다.

string

업로드할 클립영상의 채널로고 contentType(가능한 값image/jpeg, image/png)
해당 값을 넣지 않으면 채널로고없이 사용하거나 채널 자체를 사용하지않을 수있습니다.

Headers
string
required

인증용 토큰

string
enum
Defaults to 2026-05-20

API 버전 (날짜 형식). 미전송 시 가장 오래된 버전이 적용됩니다.

Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의