사용하는 두 가지 방법
ClipOnIt의 두 제품을 내 코드에서 호출하거나 에이전트로 불러 쓸 수 있습니다.
AI Explainer
교육용 도구: 강의마다 설명 영상 하나
제품에서 강의 제목이나 텍스트를 보내면, ClipOnIt이 장면을 쓰고 삽화를 넣고 음성과 자막을 입힌 뒤 강의 옆에 표시할 세로형 MP4를 렌더링해요.
POST /api/agent/produceMCP
ClipOnIt을 조작하는 AI 에이전트
에이전트(Claude, Cursor, VS Code 또는 직접 만든 것)를 MCP 서버에 연결하세요. 에이전트가 영상을 가져오고, 클립을 고르고, 설명 영상을 만들고, 이미 설명된 도구로 결과를 기다려요.
POST /mcp
언제나 같은 흐름
영상 제작은 밀리초가 아니라 몇 분이 걸려요. 작업을 만들고, 상태를 확인하고, 파일을 가져오세요.
- 작업 만들기
영상 주제나 링크를 담아 POST 요청을 보내세요. 식별자가 바로 응답으로 돌아옵니다.
- 상태 확인
약 10초마다 GET 요청: 단계, 진행률, 남은 시간. Explainer라면 웹훅으로 대신 알림을 받을 수도 있습니다.
- 영상 가져오기
완료되면 응답에 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"const API = "https://cliponit.app";
const headers = {
Authorization: `Bearer ${process.env.CLIPONIT_API_KEY}`,
"Content-Type": "application/json",
};
async function call(method, path, body) {
const res = await fetch(API + path, { method, headers, body: body && JSON.stringify(body) });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
return res.json();
}
let { job } = await call("POST", "/api/agent/produce", { topic: "La photosynthèse en 3 étapes", duration_s: 45 });
while (!["done", "failed", "canceled"].includes(job.status)) {
await new Promise((r) => setTimeout(r, 10_000));
job = await call("GET", `/api/jobs/${job.id}`);
}
console.log(job.status === "done" ? job.url : job.error);import json, os, time, urllib.request
API = "https://cliponit.app"
KEY = os.environ["CLIPONIT_API_KEY"]
def call(method, path, body=None):
req = urllib.request.Request(API + path, method=method,
data=None if body is None else json.dumps(body).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"})
with urllib.request.urlopen(req) as r:
return json.load(r)
job = call("POST", "/api/agent/produce", {"topic": "La photosynthèse en 3 étapes", "duration_s": 45})["job"]
while job["status"] not in ("done", "failed", "canceled"):
time.sleep(10)
job = call("GET", f"/api/jobs/{job['id']}")
if job["status"] == "done":
urllib.request.urlretrieve(job["url"], "lecon.mp4")
else:
print(job["error"])MCP
에이전트를 위한 MCP 서버
단일 주소 https://cliponit.app/mcp, HTTP ‘streamable’ 방식이에요. 도구는 두 제품을 모두 다뤄요: 영상 가져오기, 대기, 클립 만들기와 내보내기, 설명 영상 제작 및 완료 대기. 무언가를 수정하는 도구에는 주석이 달려 있어, 에이전트가 먼저 확인을 요청해요.
Claude Desktop과 Claude.ai: 설정 → 커넥터 → 사용자 지정 커넥터 추가에서 위 주소를 입력하세요. OAuth로 연결하므로 복사할 키가 없어요. ChatGPT도 같은 방식으로 작동해요. 단계별 안내
claude mcp add --transport http cliponit https://cliponit.app/mcp \
--header "Authorization: Bearer $CLIPONIT_API_KEY"{
"mcpServers": {
"cliponit": {
"url": "https://cliponit.app/mcp",
"headers": { "Authorization": "Bearer ${env:CLIPONIT_API_KEY}" }
}
}
}{
"inputs": [
{ "type": "promptString", "id": "cliponit-key", "description": "ClipOnIt API key", "password": true }
],
"servers": {
"cliponit": {
"type": "http",
"url": "https://cliponit.app/mcp",
"headers": { "Authorization": "Bearer ${input:cliponit-key}" }
}
}
}curl -s -X POST https://cliponit.app/mcp \
-H "Authorization: Bearer $CLIPONIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_quota", "arguments": {}}}'물어보는 대신 알림 받기
설정 → 연동에서 최대 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 호출도 인터페이스와 같은 방식으로 집계됩니다: 같은 할당량, 같은 계정. 요금제 보기
| 무료 | Starter | Pro | Business | |
|---|---|---|---|---|
| API 및 MCP | — | ✓ | ✓ | ✓ |
| 월별 Explainer 영상 | — | 15 | 30 | 100 |
| 동시에 진행되는 Explainer 제작 | — | 2 | 2 | 2 |
| 계정별 API 키 | — | 10 | 10 | 10 |
| 계정별 웹훅 | — | 3 | 3 | 3 |
- 키는 서버에만 두세요.이 키로 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.