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

# 클립 정보 등록

`POST /clip`

## Request

- Base URL: `https://stage.api.sauceclip.com`
- URL: `https://stage.api.sauceclip.com/clip`
- Auth: none required

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.dev/sauce/apis/sauceclip.md) - [All operations](https://skmtc.dev/sauce/apis/sauceclip/llms.txt) - [OpenAPI document](https://skmtc.dev/sauce/apis/sauceclip/revisions/f85dc9812369?raw)