---
title: "클립 정보 등록"
method: POST
path: "/clip"
---

# 클립 정보 등록

`POST /clip`

2026-05-20 버전의 클립 정보 등록 API입니다.

## Headers

- `authorization ` string, required
- `x-api-version` '2026-05-20'

## Request body

- object
  - `clipSourceFileName` string, required — 클립 영상 파일명
  - `thumbnailFileName` string — 썸네일 파일명
  - `channelLogoFileName` string — 채널 로고 파일명
  - `clipInfo` object, required — 클립 정보
    - `description` string — 클립 타이틀(설명)
    - `type` 'clip' | 'reward' | 'advertise' — 클립 타입(clip-클립|reward-리워드|advertise-광고)
    - `state` 'public' | 'private' | 'progress' — 클립 상태(public-공개|private-비공개|progress-변환중)
    - `displayStartedAt` string — 클립 공개 시작 일자 null일 시 종료일까지 공개 시작일, 종료일 둘다 없을시 상시 공개
    - `displayEndedAt` string — 클립 공개 종료 일자 null일 시 공개종료일 없이 공개 시작일, 종료일 둘다 없을시 상시 공개
    - `thumbnailType` 'AUTO' | 'CUSTOM' — 썸네일 타입 [AUTO, CUSTOM] 썸네일을 직접 등록하고싶은 경우 CUSTOM으로 보내야함.
    - `isChannelUsed` boolean — 플레이어 내 채널 사용 여부
    - `channelName` string — 채널명
    - `channelUrl` string — 채널 URL
    - `isTagUsed` boolean — 플레이어 내 태그 사용여부
    - `clipTags` object[] — 클립 태그 객체 배열
      - `tag` string — 태그명
    - `clipMemo` string — 클립 메모(내부 관리용)
    - `isCommentUsed` boolean — 플레이어 내 댓글 사용여부
    - `introduction` string — 클립 소개글
    - `isPageViewCountVisible` boolean — 플레이어 내 pv 공개 여부
    - `curationIds` number[] — 연결할 큐레이션 ID 배열
    - `products` object[] — 클립 상품 객체 배열
      - `productId` number — 상품 ID
      - `displayYn` boolean — 플레이어 내 상품 공개 여부

## Response `200`

- object
  - `timestamp` string, required — 응답 시간
  - `requestId` string — 요청 ID
  - `data` object — 응답 데이터
    - `clipId` number — 클립 ID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/sauce/apis/authorize-v2.md) · [All operations](https://skmtc.net/sauce/apis/authorize-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sauce/authorize-v2/versions/17497c96804d/schema)