Transcripciones de VideoScript
Qué hace esta habilidad
Ejecuta el cliente de línea de comandos videoscript. El CLI se comunica con la API pública de VideoScript usando una clave que el usuario generó para sí mismo; el servicio realiza la extracción, transcripción y facturación. Esta habilidad nunca habla HTTP por sí misma y nunca maneja una clave.
Antes de cualquier otra cosa
videoscript auth status --json
{"authenticated": true, ...}→ continuar.- Código de salida 3 → el usuario no ha iniciado sesión. Dile que cree una clave API en el sitio web de VideoScript y ejecute
videoscript auth login --token <clave>él mismo. Nunca le pidas que pegue la clave en la conversación y nunca la muestres. videoscriptno encontrado → pide al usuario que lo instale (npm install -g videoscript).
El flujo normal
# 1. enviar (devuelve un id de tarea inmediatamente)
videoscript transcribe create "<url>" --json
# 2. esperar (respeta el Retry-After del servidor)
videoscript transcribe wait <id> --json
# 3. escribir la transcripción en un archivo, no en el chat
videoscript transcript get <id> --format markdown --output notas/<nombre>.md
Reglas importantes:
- Una presentación = una clave de idempotencia. El CLI la genera y la muestra en
--json; si hay que reintentar una llamada, reutiliza esa clave (--idempotency-key) para que al usuario no se le cobre dos veces. - Las transcripciones largas van a archivos. Lee el archivo solo hasta donde lo requiera la solicitud del usuario. Nunca pegues una transcripción de una hora completa en la conversación.
- El consumo es visible. Cada tarea completada gasta los Créditos del usuario y aparece en su biblioteca; dilo antes de enviar algo largo.
- Los límites de contenido son del servicio, no tuyos para sortear. Inicios de sesión, contenido de pago, DRM, bloqueos regionales y transmisiones en vivo son rechazados por diseño. No sugieras proxies, cookies ni descargadores de terceros.
Cuando algo sale mal
Códigos de salida: 3 inicio de sesión, 4 tarea inexistente, 5 reintentar más tarde, 6 Créditos/presupuesto, 7 la fuente es rechazada.
5→ espera elRetry-Afterque informa el CLI, luego reintenta. El CLI ya reintenta dos veces por sí mismo.6→ dile al usuario que su saldo o el presupuesto de esta clave está agotado; nunca intentes una compra.7→ explica la restricción claramente y detente. No reintentes.1/2→ error inesperado o argumentos incorrectos; lee el mensaje, corrige la llamada.
Tablas completas: reference/cli.md y reference/errors.md.
Qué NO hace esta habilidad
Subidas, trabajos por lotes, eliminación de tareas, pagos, acciones de administración ni nada que requiera la contraseña del usuario. Los alcances de la clave son aplicados por el servicio.