Empieza en 5 Minutos

Aprende a usar la API de LectorAI para traducir libros programáticamente.

Requisitos Previos

Una cuenta en LectorAI (crear cuenta)
Node.js 18 o superior (para el SDK)
Un archivo EPUB o PDF para traducir

Obtén tu API Key

Ve a Configuración → API Keys y crea una nueva key.

# Tu API key se verá así:
lector_a1b2c3d4e5f6g7h8i9j0...

Instala el SDK

# Con npm
npm install @lectorai/sdk

# O con yarn
yarn add @lectorai/sdk

Sube un libro

import { LectorAI } from '@lectorai/sdk';

const client = new LectorAI({
  apiKey: process.env.LECTORAI_API_KEY
});

// Subir libro desde archivo
const { book } = await client.books.upload('./mi-libro.epub', {
  title: 'Mi Libro en Inglés',
  author: 'John Doe'
});

console.log('Libro subido:', book.id);
console.log('Capítulos:', book.chapterCount);

Inicia la traducción

// Iniciar traducción con GPT-4o Mini
await client.translate.start(book.id, {
  model: 'gpt-4o-mini',      // o 'gpt-4o', 'claude-sonnet', 'claude-haiku'
  targetLanguage: 'es'       // español
});

// Esperar a que termine (con progreso)
const result = await client.books.waitForCompletion(book.id, {
  onProgress: (event) => {
    console.log(`Progreso: ${event.progress}%`);
    console.log(`Capítulo: ${event.currentChapter}/${event.totalChapters}`);
  }
});

console.log('Traducción completada!');

Descarga el libro traducido

import fs from 'fs';

// Generar el EPUB
await client.download.generateEpub(book.id);

// Descargar como Buffer
const epubBuffer = await client.download.downloadEpub(book.id);

// Guardar a disco
fs.writeFileSync('mi-libro-traducido.epub', epubBuffer);

console.log('EPUB guardado!');

// O obtener URL de descarga
const { url } = await client.download.getUrl(book.id, 'epub');
console.log('URL de descarga:', url);

Ejemplo Completo

translate-book.js

Script completo para traducir un libro

import { LectorAI } from '@lectorai/sdk';
import fs from 'fs';

async function translateBook(inputPath, outputPath) {
  const client = new LectorAI({
    apiKey: process.env.LECTORAI_API_KEY
  });

  console.log('📚 Subiendo libro...');
  const { book } = await client.books.upload(inputPath);
  console.log(`✓ Libro subido: ${book.title} (${book.chapterCount} capítulos)`);

  console.log('🔄 Iniciando traducción...');
  await client.translate.start(book.id, { model: 'gpt-4o-mini' });

  console.log('⏳ Esperando traducción...');
  await client.books.waitForCompletion(book.id, {
    onProgress: (e) => process.stdout.write(`\r   Progreso: ${e.progress}%`)
  });
  console.log('\n✓ Traducción completada!');

  console.log('📥 Generando EPUB...');
  await client.download.generateEpub(book.id);
  const epub = await client.download.downloadEpub(book.id);
  fs.writeFileSync(outputPath, epub);
  console.log(`✓ Guardado en: ${outputPath}`);
}

// Uso
translateBook('./book.epub', './book-translated.epub')
  .catch(console.error);

Modo DeveloperSin límites

¿Eres desarrollador? Usa tus propias API keys

Si tienes rol DEV, puedes configurar tus propias API keys de OpenAI y Anthropic para traducir sin límites de libros ni palabras.

Sin límites

Tus propias keys

Encriptación AES-256

Ver cómo configurar API keys personales →