API Docs/CLI Tool
@lectorai/cli

CLI Tool

Traduce libros directamente desde tu terminal sin escribir código.

Instalación
npm install -g @lectorai/cli
Inicio Rápido
Traduce un libro en 2 comandos
# 1. Configurar API key (solo una vez)
lectorai config set api_key lector_tu_api_key

# 2. Traducir un libro
lectorai translate libro.epub --model gpt-4o-mini --output traducido.epub

Comandos

configConfiguración
# Guardar API key
lectorai config set api_key lector_xxx

# Ver configuración actual
lectorai config list

# Ver ruta del archivo de config
lectorai config path
translateTraducir libro
# Traducción básica
lectorai translate libro.epub

# Con todas las opciones
lectorai translate libro.epub \
  --title "Mi Libro" \
  --author "Autor" \
  --model gpt-4o-mini \
  --source en \
  --dest es \
  --output traducido.epub

# Sin esperar (modo background)
lectorai translate libro.epub --no-wait

Opciones:

  • -t, --title - Título del libro
  • -a, --author - Autor
  • -m, --model - Modelo (gpt-4o, gpt-4o-mini, claude-sonnet, claude-haiku)
  • -s, --source - Idioma origen (default: en)
  • -d, --dest - Idioma destino (default: es)
  • -o, --output - Archivo de salida
booksGestionar libros
# Listar todos los libros
lectorai books list

# Filtrar por estado
lectorai books list --status COMPLETED

# Ver detalles de un libro
lectorai books get <book-id>

# Eliminar un libro
lectorai books delete <book-id> --force
statusVer estado
# Ver estado actual
lectorai status <book-id>

# Modo watch (barra de progreso en tiempo real)
lectorai status <book-id> --watch
downloadDescargar
# Descargar como EPUB
lectorai download <book-id> -o traducido.epub

# Descargar como PDF
lectorai download <book-id> -o traducido.pdf --format pdf
usageVer uso
# Ver estadísticas de uso
lectorai usage

# Muestra:
# - Libros usados este mes
# - Palabras traducidas
# - Plan actual
# - Fecha de reinicio

Ejemplo Completo

# 1. Configurar (solo una vez)
lectorai config set api_key lector_abc123

# 2. Traducir libro con barra de progreso
lectorai translate "The Great Gatsby.epub" \
  --model gpt-4o-mini \
  --output "El Gran Gatsby.epub"

# 3. Verificar uso
lectorai usage

# Output:
# ✓ Uploaded: clx123abc
# ✓ Translation started
# █████████████████░░░ | 85% | TRANSLATING
# ✓ Translation completed!
# ✓ Downloaded to: El Gran Gatsby.epub

Script para Múltiples Libros

#!/bin/bash
# translate-all.sh

for file in books/*.epub; do
  echo "Traduciendo: $file"
  lectorai translate "$file" --no-wait
done

echo "Traducciones iniciadas. Ver estado con:"
echo "lectorai books list"

Requisitos

  • Node.js18+
  • npmo yarn / pnpm

Obtén tu API Key

Crea una API key en configuración para usar el CLI

Ir a ConfiguraciónVer API Docs