Kaloclip AI 비디오 제작 (clip)
Kaloclip은 제품 정보와 이미지를 짧은 동영상 스크립트로, 스크립트를 완성된 동영상으로 변환합니다. 계정은 API 키를 소유한 계정입니다: 크레딧, Kaloclip 멤버십(동영상 대기열 크기, Free 요금제 워터마크), 이미지 에셋 및 작업. 대부분의 명령은 무료입니다. [credits] 명령은 유료 작업을 제출합니다. 사용하기 전에 "크레딧 사용"을 참조하세요.
실행
CLI는 이 스킬 내에 포함되어 있습니다(scripts/clip.py, Python 3.11+ stdlib만 필요 — 설치 불필요):
python3 <this-skill-dir>/scripts/clip.py options
아래 모든 예제에서 clip은 python3 <this-skill-dir>/scripts/clip.py의 약어로 사용됩니다.
출력은 stdout에 TOON(토큰 지향) 형식입니다. 원시 JSON을 보려면 명령에 --json을 추가하세요.
오류는 구조화되어 stdout에 실행 가능한 help: 줄과 함께 표시됩니다. 종료 코드: 0 정상, 1 오류, 2 사용법 오류.
설정 — 첫 번째 호출 전에 확인하세요
모든 명령에는 KaloData OpenAPI 키가 필요합니다(secret-key 헤더로 전송). 이 키는 kalodata 스킬의 kalo CLI에서 사용하는 키와 동일하며, 동일한 위치에 저장됩니다. 세션의 첫 번째 호출 전에 clip config를 실행하고 api_key를 확인하세요. missing이라고 표시되면 중단하세요. 키를 추측하지 말고 재시도하지 마세요. 사용자에게 다음 단계를 안내하고 기다리세요:
-
키 획득 — https://www.kalodata.com/open-center/account 에 로그인하고 키 생성을 클릭하세요. 계정이 없나요? 먼저 https://www.kalodata.com/open-center/home 에서 등록하세요.
-
저장 —
clip config set --key <API_KEY>(~/.config/kalodata/config.toml에 저장, 모드 0600,kalo와 공유) 또는 환경 변수KALODATA_API_KEY를 설정하세요. -
크레딧 — KaloData와 동일한 크레딧 잔액입니다. Kaloclip 가격 및 멤버십 규칙이 적용됩니다.
clip credit로 잔액을 확인하세요.호출 크레딧 options,credit,product resolve,image upload/import,video preview,get/job무료 script create2 video createvideo preview가 모델/지속 시간/해상도에 대해 표시하는 크레딧 (예: sd2 · 15s · 720P = 28)analysis create스크립트 분석에 대한 Kaloclip 가격
명령어
| 명령어 | 설명 |
|---|---|
clip options | 현재 사용 가능한 모델, 지속 시간, 해상도; 각 모델에서 허용되는 지속 시간 |
clip credit | 남은 크레딧 |
clip product resolve <link> | 제품 링크 → 제목, 카테고리, 판매 포인트, 이미지 에셋 |
clip image upload <file...> | 1~6개의 로컬 이미지(JPEG/PNG/GIF/WebP, ≤5MB) → 에셋 ID |
clip image import <url...> | 1~6개의 공개 https 이미지 URL → 에셋 ID |
clip script create | [credits] 스크립트 초안 작성; --product-link 또는 --image --title --category |
clip script get <job_id> | 초안 상태 및 스크립트 텍스트; --wait |
clip script candidates <job_id> | Kaloclip 웹사이트에서 생성된 재작성 작업의 두 후보 |
clip video preview | 동영상에 소요될 크레딧; --model --duration --resolution --ratio |
clip video create | [credits] 최종 스크립트 → 동영상; --script-job / --script-file / --script |
clip video get <job_id> | 동영상 상태; 완료 시 videoUrl; --wait |
clip analysis create <video_url> | [credits] 기존 동영상의 샷별 분석; --commerce --country |
clip analysis get <job_id> | 분석 상태 및 결과 (30일간 보관); --wait |
clip job <job_id> | 모든 작업의 상태 및 출력; --wait |
clip config | 키(kalo와 공유) 및 엔드포인트 표시/설정 (--base-url staging) |
동영상 제작 플로우
clip options— 출력에서--model과--duration을 함께 선택하세요. 모델과 지속 시간은 변경될 수 있습니다. 기억에 의존하지 마세요.- 제품 자료, 다음 중 하나:
clip product resolve <link>로 링크가 생성하는 내용을 확인한 다음, 동일한--product-link를script create에 전달하세요. 또는- 사용자 자신의 이미지:
clip image upload a.png b.jpg→--image ASSET_ID=IMAGE_URL(1~6회 반복), 추가로--title과--category.
- 동영상의 느낌(톤, 장면, 훅)을 질문하고
--description으로 전달하세요. clip script create --product-link <link> --model <M> --duration <S> --description "..."→ 드라이 런. 표시하고 승인을 받은 후,--yes --idempotency-key <hint의 키> --wait으로 재실행하세요(초안 작성에는 약 30~60초 소요; 크레딧은 제출 시 청구).- 스크립트를 표시하세요. 변경하려면 편집한 텍스트를 파일에 저장하고
--script-file을 사용하세요. clip video create --script-job <job_id> [--script-file edited.txt] [--resolution 1080P]→ 크레딧 비용을 포함한 드라이 런. 승인을 받은 후--yes --idempotency-key <key>로 재실행하세요.clip video get <job_id> --wait— 15초 동영상은 약 15분 소요(--wait는 최대 20초 폴링). 사용자에게 실행 중임을 알리세요.--wait시간 초과 시 다시 폴링하세요. 절대 재제출하지 마세요.videoUrl(mp4) 및coverImageUrl을 사용자에게 전달하세요.
--script-job은 초안이 이 기기에서 작성될 때 사용된 이미지, 제목, 모델 및 지속 시간을 재사용합니다. 그렇지 않은 경우 다시 전달하세요(--product-link가 대부분을 충당합니다).
크레딧 사용
[credits] 명령은 첫 번째 실행에서는 절대 작동하지 않습니다: --yes 없이 정확한 요청(dry_run:), 크레딧 비용 및 멱등성 키를 출력하고 아무것도 전송하지 않습니다. 사용자에게 표시하고 명시적인 승인을 받은 후 --yes --idempotency-key <key>로 재실행하세요. --yes를 직접 추가하지 말고, 제출을 반복하지 마세요.
- 재시도: 제출이 "결과를 알 수 없음"(시간 초과 / 5xx / SUBMISSION_IN_PROGRESS)으로 끝나는 경우, 5분 이내에 동일한
--idempotency-key로 동일한 명령을 다시 실행하세요. 그러면 Kaloclip이 원래 작업을 반환하고 다시 청구하지 않습니다. 새 키는 새 유료 작업을 의미합니다.SUBMISSION_OUTCOME_UNKNOWN: 중단하고 사용자에게 알리세요. 재제출하지 마세요. - 작업은 비동기식입니다: 작업 ID를 보관하고
--wait(5초마다)로 폴링하세요.queued또는processing상태인 작업을 다시 제출하지 마세요. TASK_QUEUE_FULL: 멤버십의 동영상 대기열이 가득 찼습니다(Free 요금제: 한 번에 하나의 동영상). 요금이 부과되지 않았습니다. 실행 중인 동영상이 완료될 때까지 기다린 후 다시 제출하세요.RATE_LIMIT_EXCEEDED: 사용자당 제한(업로드/가져오기 10회/분, 제품 확인 10회/분, 미리보기 20회/분, 동영상 5회/분) — 최소 60초 기다리세요.
스크립트 분석
clip analysis create <tiktok|kalodata|youtube-shorts url>은 동영상을 장면으로 분해합니다(video_scripts[]: 시간, 샷 규모, 시각적 설명, 음성 해설, 각각 번역 포함), 발표자 성별, 사용 언어, 카메라 움직임 및 효과적인 이유를 포함합니다. 쇼핑 가능한 TikTok 동영상: --commerce --country US를 추가하세요. 결과는 30일 동안 읽을 수 있습니다(clip analysis get <job_id>). 모든 필드를 보려면 --json을 추가하세요. 자신의 스크립트를 작성하기 전에 인기 동영상에서 배우는 데 사용하세요.
데이터를 올바르게 읽기
- 완료된 초안의 스크립트는 장문의 지시 사항(인재, 스타일, 장면, 장면별 VISUAL / AUDIO / TALENT ACTION)입니다. 전체를 표시하세요. 사용자가 승인하기 전에 요약하지 마세요.
video preview는 추정치입니다. 제출이 거부될 수 있습니다(대기열, 멤버십, 입력).videoUrl은 완성된 파일입니다. Free 멤버십 동영상에는 워터마크가 있습니다.product resolve의selling_points는 Kaloclip이 제품을 분석하는 동안 비어 있을 수 있습니다. 1분 후에 다시 실행하거나 없이 진행하세요.- 이미지 에셋은 계정에 속합니다. 한 키의 에셋 ID는 다른 키와 함께 작동하지 않습니다.