채널

네이버 클립

에이전트가 uplika 로 네이버 클립에 세로 영상을 올리는 방법: 필요한 브라우저 확장, 사람이 먼저 만드는 클립 프로필, 카테고리와 해시태그, 비공개 클립과 임시저장의 차이.

한눈에 보기

이름	타입	설명
`characters`	text	300
`images`	media	not supported; a video with images attached goes out as the video alone, with a warning
`carousel`	media	not supported
`video`	media	1 per post
`text alone`	media	media required
`posts / 24h`	limit	20
`deletes / 24h`	limit	Naver Clip deletion is not offered yet; delete the clip in Clip Creators
`status`	state	soon

숫자는 서버가 검증하는 파일과 같은 곳에서 옵니다. 클립은 영상 하나입니다. 사진과 글만 있는 글은 받지 않습니다. 설명은 UTF-16 단위로 세어 기본 평면 밖 이모지는 둘로 칩니다. 네이버는 상한을 넘는 부분을 말없이 잘라 내므로 uplika 가 먼저 거절합니다.

네이버 클립에는 무엇이 필요한가요?

네이버 클립은 공식 업로드 API 가 없습니다. 네이버 블로그처럼 그 사람의 브라우저(크롬 · 엣지 · 웨일)에 깔린 uplika 확장이 연결한 네이버 계정으로 클립 크리에이터에서 올립니다. 확장 0.7.32 이상과 확장이 묻는 네이버 권한이 필요합니다. 그 네이버 계정에 클립 프로필이 먼저 있어야 합니다. 프로필 만들기는 네이버 쪽 가입이라 uplika 가 대신 만들지 않습니다.

첫 클립은 어떻게 올리나요?

세로 영상을 올리고 list_accounts 에서 그 계정의 naverClip.categories 를 읽은 뒤, 미디어 id 와 categoryId 로 publish 를 부릅니다. 먼저 bridge_status 를 부르세요. 확장이 깔린 브라우저가 닫혀 있으면 클립은 대기열에서 기다립니다.

curl -X POST https://api.uplika.com/v1/posts \
  -H "Authorization: Bearer $UPLIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Evening walk in the park",
    "accountIds": ["conn_..."],
    "mediaIds": ["med_..."],
    "options": { "naver_clip": { "categoryId": "169", "tags": ["walk", "park"], "visibility": "public" } }
  }'

options.naver_clip 이 받는 것

이름	타입	설명
`tags`	string[]	Up to 5 hashtags without the # sign. Naver Clip has no separate tag field: they are appended to the description as #tag, so the description plus tags must stay within 300 characters, and #words you already wrote in the description count toward the 5.
`categoryId`	string	Required. A category id from naverClip.categories in list_accounts (Naver Clip categories have two levels and the id is the second-level one). Give this or category (the name); there is no default.
`category`	string	The category name instead of its id, exactly as it appears in naverClip.categories from list_accounts (the main and sub category names joined with ›). (API only; the dashboard does not draw it.)
`visibility`	public \| private	public (default) or private (only the account owner can see it). A private clip is still posted.
`aiGenerated`	boolean	Turn on Naver Clip's AI-use label. An attached video marked aiGenerated turns this on automatically unless you set it to false.
`adDisclosure`	boolean	Turn on the ad and sponsorship label (paid promotion, sponsorship or PPL). A legal statement, so set it yourself.
`disableComments`	boolean	Turn comments off for this clip. Comments are allowed by default.
`draftOnly`	boolean	Upload and save it as a draft in Naver Clip Creators instead of posting. The person finishes it there. Different from visibility private, which posts the clip where only the owner sees it, and from draft on the post, which keeps the whole post on uplika.
`content`	string	Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content.

서버가 검증하는 스키마에서 그대로 만듭니다. 네이버 클립에는 해시태그 칸이 따로 없어 태그는 설명 끝에 #태그 로 붙고, 이미 쓴 #낱말도 다섯 개에 셉니다.

비공개 클립과 임시저장은 어떻게 다른가요?

visibility private 는 클립을 올리되 계정 주인만 보게 합니다. draftOnly 는 영상을 올려 클립 크리에이터 콘텐츠의 임시저장으로 남기고, 사람이 거기서 마무리하기 전까지 아무것도 게시하지 않습니다. 글의 draft 는 또 다릅니다. 아무것도 올리지 않고 글 전체를 uplika 에 둡니다.

아직 안 되는 것은 무엇인가요?

이번 판은 클립 올리기만 합니다. 클립 읽기 · 목록 · 수정 · 삭제 · 지표 · 댓글은 이유와 함께 거절하니 클립 크리에이터에서 합니다. 커버 이미지 · 음악 · 장소 · 재생목록 · 네이버 자체 예약도 없습니다. 예약은 글의 scheduledAt 으로 합니다.

자주 묻는 질문

네이버 계정에 클립 프로필이 없다고 나와요.

네이버 계정에는 사람이 클립 크리에이터에서 만들기 전까지 클립 프로필이 없습니다. 거기서 만든 뒤 연결에서 네이버 클립을 다시 연결하세요.

클립이 정말 올라갔는지 어떻게 아나요?

확장은 등록을 누른 뒤 클립 목록을 다시 읽어 그 영상이 정확히 하나 있을 때만 성공이라고 알립니다. 못 찾으면 clip_unconfirmed 로 실패합니다. 다시 보내기 전에 클립 크리에이터 콘텐츠를 먼저 보세요.

네이버 블로그와 네이버 클립을 다른 네이버 계정으로 쓸 수 있나요?

네. 둘 다 확장의 같은 네이버 계정 목록에서 고르고, 워크스페이스마다 네이버 블로그 하나와 네이버 클립 하나를 둡니다. 같은 네이버 로그인이어도 되고 달라도 됩니다.