개발자와 SaaS를 위한 서비스

몇 번의 호출로 제품에 AI 영상 추가하기

REST API, MCP 서버, 웹훅을 제공해요. 제품에서 설명 영상을 만들고 긴 영상을 쇼츠로 잘라낼 수 있으며, 사용자가 ClipOnIt을 직접 열 필요는 없어요.

무료 요금제부터 가능 (월 3개 영상, 워터마크 포함) · API 키는 설정 → 통합에서 만들 수 있습니다

사용하는 두 가지 방법

ClipOnIt의 두 제품을 내 코드에서 호출하거나 에이전트로 불러 쓸 수 있습니다.

  • AI Explainer

    교육용 도구: 강의마다 설명 영상 하나

    제품에서 강의 제목이나 텍스트를 보내면, ClipOnIt이 장면을 쓰고 삽화를 넣고 음성과 자막을 입힌 뒤 강의 옆에 표시할 세로형 MP4를 렌더링해요.

    POST /api/agent/produce

  • MCP

    ClipOnIt을 조작하는 AI 에이전트

    에이전트(Claude, Cursor, VS Code 또는 직접 만든 것)를 MCP 서버에 연결하세요. 에이전트가 영상을 가져오고, 클립을 고르고, 설명 영상을 만들고, 이미 설명된 도구로 결과를 기다려요.

    POST /mcp

언제나 같은 흐름

영상 제작은 밀리초가 아니라 몇 분이 걸려요. 작업을 만들고, 상태를 확인하고, 파일을 가져오세요.

  1. 작업 만들기

    영상 주제나 링크를 담아 POST 요청을 보내세요. 식별자가 바로 응답으로 돌아옵니다.

  2. 상태 확인

    약 10초마다 GET 요청: 단계, 진행률, 남은 시간. Explainer라면 웹훅으로 대신 알림을 받을 수도 있습니다.

  3. 영상 가져오기

    완료되면 응답에 MP4 URL이 들어 있어요. 다운로드하거나 제품에 바로 표시하세요.

AI Explainer

주제로 설명 영상 만들기

POST /api/agent/produce는 주제(또는 스크립트, 음성 녹음)를 받아 작성과 렌더링을 시작해요. GET /api/jobs/{id}는 status, step, percent를 반환하고, 영상이 준비되면 url을 반환해요.

  • duration_s15~180초
  • style24개 비주얼 스타일, 그리고 내 스타일 : GET /api/explainer/styles
  • voice카탈로그의 음성, 이름 또는 식별자로 찾기
  • dry_runtrue: 아무것도 실행하지 않고 할당량과 비용만 확인해요
curl -s -X POST https://cliponit.app/api/agent/produce \
  -H "Authorization: Bearer $CLIPONIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "La photosynthèse en 3 étapes", "duration_s": 45}'

curl -s https://cliponit.app/api/jobs/JOB_ID \
  -H "Authorization: Bearer $CLIPONIT_API_KEY"

curl -s -o lecon.mp4 "URL_DU_JOB"

MCP

에이전트를 위한 MCP 서버

단일 주소 https://cliponit.app/mcp, HTTP ‘streamable’ 방식이에요. 도구는 두 제품을 모두 다뤄요: 영상 가져오기, 대기, 클립 만들기와 내보내기, 설명 영상 제작 및 완료 대기. 무언가를 수정하는 도구에는 주석이 달려 있어, 에이전트가 먼저 확인을 요청해요.

Claude Desktop과 Claude.ai: 설정 → 커넥터 → 사용자 지정 커넥터 추가에서 위 주소를 입력하세요. OAuth로 연결하므로 복사할 키가 없어요. ChatGPT도 같은 방식으로 작동해요. 단계별 안내

Claude로 영상 만들기: 도구, 예시, 할당량

claude mcp add --transport http cliponit https://cliponit.app/mcp \
  --header "Authorization: Bearer $CLIPONIT_API_KEY"

물어보는 대신 알림 받기

설정 → 연동에서 최대 3개의 https URL을 추가하세요. Explainer 제작이 끝나면 ClipOnIt가 job.done 또는 job.failed를 보내며, GET /api/jobs/{id}와 같은 객체를 담습니다. 실패하면 약 8시간 동안 여섯 번 재시도합니다.

Smart Clipper 클립에는 아직 웹훅이 없어요. GET으로 상태를 확인하세요.

import hashlib, hmac, time

def verify(secret: str, header: str, body: bytes, tolerance: int = 300) -> bool:
    """header = X-ClipOnIt-Signature, body = raw request bytes."""
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    if abs(time.time() - int(parts.get("t", 0))) > tolerance:
        return False
    mac = hmac.new(secret.encode(), parts["t"].encode() + b"." + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, parts.get("v1", ""))

플랜별 한도와 할당량

API 호출도 인터페이스와 같은 방식으로 집계됩니다: 같은 할당량, 같은 계정. 요금제 보기

무료StarterProBusiness
API 및 MCP—✓✓✓
월별 Explainer 영상—1530100
동시에 진행되는 Explainer 제작—222
계정별 API 키—101010
계정별 웹훅—333

보안

ClipOnIt은 사용자의 브라우저가 아니라 반드시 서버에서 호출하세요.

개인정보 처리방침
  • 키는 서버에만 두세요.이 키로 ClipOnIt 계정 전체에 접근할 수 있어요. 브라우저, 모바일 앱, Git 저장소에는 절대 넣지 마세요. 환경 변수에 보관하고 백엔드에서 ClipOnIt을 호출하세요.
  • 용도별 키, 범위 포함.범위는 ‘읽기’(조회, 확인) 또는 ‘제작’(영상 생성)입니다. 각 키에는 이름과 마지막 사용 날짜가 있으며, 클릭 한 번으로 취소할 수 있습니다. 취소하면 다음 호출부터 401.
  • 비밀 키는 한 번만 표시됩니다.ClipOnIt은 지문(SHA-256)만 보관합니다. 키를 잃어버리면 새로 만들어 교체해야 하며, 다시 확인할 수는 없어요.
  • 서명된 웹훅.각 전송에는 X-ClipOnIt-Signature 헤더가 포함됩니다(본문과 타임스탬프의 HMAC-SHA256). 5분보다 오래된 전송은 거부합니다. 수신 URL은 https이며 매 전송마다 검증됩니다.
  • 유럽연합 내 호스팅.서버는 EU의 Hetzner에 있으며, 하위 처리자는 개인정보처리방침에 나열되어 있습니다.

자주 묻는 질문

SDK, 위젯, 처리 시간, 할당량, 처리량.

API를 사용하려면 어떤 요금제가 필요한가요?

무료 요금제만으로도 시작할 수 있습니다. API 키를 만들면 MCP 서버가 응답하며, 워터마크가 있는 Explainer 영상 월 3개와 무료 스타일 8개를 사용할 수 있습니다. 유료 요금제에서는 영상이 더 늘어나고(15, 30 또는 100개/월), 워터마크가 없으며, 스타일 24개, 마이크 음성, AI 감독을 쓸 수 있습니다. API 할당량은 인터페이스에서와 마찬가지로 계정 기준입니다.

SDK가 있나요?

아직 공식 SDK는 없습니다. API는 HTTP와 JSON으로 제공되며 OpenAPI 3.1(/openapi.json)로 문서화되어 있습니다. 이 페이지의 예시는 몇 줄의 fetch나 표준 Python으로 충분하며, OpenAPI 파일로 클라이언트를 생성할 수도 있어요.

ClipOnIt 플레이어나 편집기를 내 사이트에 넣을 수 있나요?

아니요, 삽입형 위젯은 없어요. MP4 파일을 받아서 직접 만든 플레이어에 표시하거나 자체 서버에 호스팅하세요.

영상 하나 만드는 데 얼마나 걸리나요?

설명 영상: 몇 분 소요 (작성 후 렌더링, 렌더링에 약 4분). 클립: 영상 20분 기준 약 1~5분, 이후 각 클립 내보내기. API는 단계, 진행률, 남은 시간 추정치를 알려줘요.

할당량에 도달하면 어떻게 되나요?

API는 402 응답과 함께 명확한 메시지를 보내요(월 할당량 또는 AI 예산), 요금제에 없는 기능이면 403, Explainer 작업 두 개가 이미 실행 중이면 429. Explainer에서 “dry_run”: true를 지정하면 실행 전에 모든 것을 확인하며, 아무것도 만들거나 청구하지 않아요.

모든 사용자에게 ClipOnIt을 연결하고 싶어요.

Une clé agit sur un seul compte ClipOnIt : les vidéos et les quotas sont ceux de ce compte. Pour un usage à plus grande échelle, écris-nous à contact@cliponit.app avec ton volume et ton cas d'usage.

API로 오늘 바로 첫 영상 만들기

Crée une clé, copie un exemple, lance-le. Une question sur ton intégration : contact@cliponit.app.

llms-api.txt · OpenAPI 3.1 · mcp.json