개요 및 빠른 시작
Sketchie는 프롬프트나 문서를 화이트보드 설명 영상으로 바꾸고, 렌더링된 영상과 편집 가능한 scene graph를 함께 돌려줍니다. 이 문서는 HTTP API, CLI, TypeScript SDK, MCP 서버에 대한 레퍼런스입니다.
API 접근은 모든 유료 요금제에 포함됩니다. 요금제에 가입하면 앱의 설정에서 API 키를 만드세요. API 생성은 앱과 동일한 요율로 요금제 분을 사용합니다. 별도의 API 요금은 없습니다.
인증
모든 요청은 API 키를 Bearer 토큰으로 인증합니다. 앱의 설정에서 키를 만든 다음 Authorization 헤더로 보내세요:
Authorization: Bearer sk_...키는 생성 시 한 번만 표시됩니다. 비밀로 유지하세요. 모든 엔드포인트의 기본 URL은 https://sketchie.ai/api입니다.
빠른 시작
1. 설명 영상 만들기
주제를 input으로 보내고, 선택적으로 목표 길이를 length로 보냅니다("0:30"이나 "1:00" 같은 친숙한 "M:SS" 문자열, 30초 단위). 자동 길이를 원하면 length를 생략하세요.
curl -X POST https://sketchie.ai/api/v1/explainer \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{
"input": "Explain how DNS resolves a domain name",
"length": "0:30"
}'호출은 대기열에 들어간 레코드와 함께 즉시 202 Accepted를 반환합니다. 렌더링은 백그라운드에서 실행되며 몇 분 걸립니다.
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "queued",
"prompt": "Explain how DNS resolves a domain name",
"lengthSeconds": 30,
"voice": "sketchie:sulafat",
"language": "en",
"aspect": "16:9",
"videoUrl": null,
"sceneGraph": null
}2. 결과 폴링하기
status가 종료 상태에 도달할 때까지 id로 설명 영상을 가져옵니다. 수명 주기는 queued, 다음 generating, 다음 rendering, 다음 ready(완료) 또는 failed입니다.
curl https://sketchie.ai/api/v1/explainer/10f00eee-d2d6-4a1b-b708-f0391faaa85b \
-H "Authorization: Bearer sk_..."ready가 되면 레코드에 영상 URL과 편집 가능한 scene graph가 담깁니다:
{
"id": "10f00eee-d2d6-4a1b-b708-f0391faaa85b",
"status": "ready",
"videoUrl": "https://sketchie.ai/media/....mp4",
"sceneGraph": { "scenes": [ ... ] }
}친숙한 필드 이름과 클래식 필드 이름. input과 length는 친숙한 요청 필드입니다. 예전의 prompt(문자열)와 lengthSeconds(숫자, 30의 양의 배수)도 별칭으로 계속 허용되므로 기존 통합은 그대로 동작합니다. 둘 다 보내면 친숙한 필드가 우선합니다.