VideoScript 트랜스크립트
이 스킬이 하는 일
videoscript 명령줄 클라이언트를 구동합니다. CLI는 사용자가 직접 발급한 키를 사용하여 공개 VideoScript API와 통신합니다. 서비스가 추출, 전사 및 결제를 처리합니다. 이 스킬은 직접 HTTP를 호출하거나 키를 처리하지 않습니다.
시작하기 전에
videoscript auth status --json
{"authenticated": true, ...}→ 계속 진행합니다.- 종료 코드 3 → 사용자가 로그인하지 않았습니다. VideoScript 웹사이트에서 API 키를 생성하고
videoscript auth login --token <key>를 직접 실행하도록 안내하세요. 사용자에게 키를 대화에 붙여넣도록 요청하거나 키를 출력하지 마세요. videoscript를 찾을 수 없음 → 사용자에게 설치(npm install -g videoscript)를 요청하세요.
일반적인 흐름
# 1. 제출 (즉시 작업 ID 반환)
videoscript transcribe create "<url>" --json
# 2. 대기 (서버의 Retry-After를 따름)
videoscript transcribe wait <id> --json
# 3. 트랜스크립트를 파일로 작성 (채팅에 직접 출력하지 않음)
videoscript transcript get <id> --format markdown --output notes/<name>.md
중요한 규칙:
- 한 번 제출 = 하나의 멱등성 키. CLI가 자동으로 생성하여
--json에 표시합니다. 재시도가 필요한 경우 해당 키를 재사용(--idempotency-key)하여 사용자가 두 번 청구되지 않도록 합니다. - 긴 트랜스크립트는 파일로 저장합니다. 사용자의 요청에 필요한 만큼만 파일을 읽습니다. 한 시간 분량의 전체 트랜스크립트를 대화에 붙여넣지 마세요.
- 소비 내역이 표시됩니다. 완료된 모든 작업은 사용자의 크레딧을 소비하고 라이브러리에 나타납니다. 긴 작업을 제출하기 전에 이를 사용자에게 알리세요.
- 콘텐츠 제한은 서비스의 규칙이며 스킬이 우회할 수 없습니다. 로그인, 유료 콘텐츠, DRM, 지역 차단, 라이브 스트림은 설계상 거부됩니다. 프록시, 쿠키 또는 타사 다운로더를 제안하지 마세요.
문제 발생 시
종료 코드: 3 로그인 오류, 4 작업 없음, 5 나중에 재시도, 6 크레딧/예산 부족, 7 소스 거부됨.
5→ CLI가 보고하는Retry-After시간 동안 기다린 후 재시도하세요. CLI는 자체적으로 두 번 재시도합니다.6→ 사용자에게 잔액 또는 이 키의 예산이 소진되었음을 알리고, 결제를 시도하지 마세요.7→ 제한 사항을 명확히 설명하고 중단하세요. 재시도하지 마세요.1/2→ 예상치 못한 오류 또는 잘못된 인수입니다. 메시지를 읽고 호출을 수정하세요.
전체 테이블: reference/cli.md 및 reference/errors.md.
이 스킬이 하지 않는 일
업로드, 일괄 작업, 작업 삭제, 결제, 관리자 작업 또는 사용자의 비밀번호가 필요한 모든 작업. 키의 범위는 서비스에 의해 강제됩니다.