@lectorai/sdk
SDK Oficial de Node.js
Integra LectorAI en tus aplicaciones y automatiza la traducción de libros con nuestra API programática.
Instalación
#npm
npm install @lectorai/sdk#yarn
yarn add @lectorai/sdk#pnpm
pnpm add @lectorai/sdkInicio Rápido
Traduce un libro en menos de 10 líneas de código
import { LectorAI } from '@lectorai/sdk';
const client = new LectorAI({
apiKey: 'lector_xxx' // Obtén tu API key en /settings
});
// 1. Subir libro
const { book } = await client.books.upload('./libro.epub', {
title: 'Mi Libro',
author: 'Autor'
});
// 2. Iniciar traducción
await client.translate.start(book.id, { model: 'gpt-4o-mini' });
// 3. Esperar completado con progreso
const result = await client.books.waitForCompletion(book.id, {
onProgress: (e) => console.log(`${e.progress}%`)
});
// 4. Descargar EPUB traducido
await client.download.generateEpub(book.id);
const epub = await client.download.downloadEpub(book.id);
fs.writeFileSync('traducido.epub', epub);Casos de Uso
Editoriales y Publishers
Automatiza la traducción de catálogos completos. Procesa cientos de libros por noche sin intervención manual.
// Traducir catálogo completo
for (const book of catalog) {
await client.books.upload(book);
await client.translate.start(book.id);
}
Integración con CMS
Conecta LectorAI con WordPress, Notion, Contentful o cualquier CMS. Traduce contenido automáticamente al publicar.
// Webhook de WordPress
app.post('/on-publish', async (req) => {
await client.books.upload(req.file);
});
Bots y Automatización
Crea bots de Telegram, Discord o Slack que reciban EPUBs y devuelvan traducciones automáticamente.
// Bot de Telegram
bot.on('document', async (ctx) => {
const epub = await ctx.file();
await client.books.upload(epub);
});
Pipelines CI/CD
Integra traducciones en tu pipeline de deployment. Genera versiones traducidas automáticamente en cada release.
# GitHub Action
- name: Translate docs
run: |
npx lectorai translate docs/
Beneficios vs Web
| Característica | Interfaz Web | SDK / API |
|---|---|---|
| Traducciones simultáneas | 1 a la vez | Ilimitadas |
| Automatización | Manual | 100% automático |
| Integración con otros sistemas | No | Cualquier plataforma |
| Volumen de procesamiento | Bajo | 10-100x mayor |
| Callbacks de progreso | Visual | Programático |
Referencia de API
client.books
.list()- Listar todos los libros.get(id)- Obtener un libro.upload(file, options)- Subir libro (path o Buffer).update(id, data)- Actualizar metadatos.delete(id)- Eliminar libro.waitForCompletion(id, options)- Esperar traducción con polling
client.translate
.start(bookId, options)- Iniciar traducción.pause(bookId)- Pausar traducción.resume(bookId)- Reanudar traducción.stop(bookId)- Detener traducción
client.download
.generateEpub(bookId)- Generar EPUB.generatePdf(bookId)- Generar PDF.downloadEpub(bookId)- Descargar EPUB como Buffer.downloadPdf(bookId)- Descargar PDF como Buffer.getUrl(bookId, format)- Obtener URL de descarga
client.usage
.get()- Obtener estadísticas de uso.canTranslate(wordCount)- Verificar si puede traducir
Obtén tu API Key
Crea una API key en configuración para empezar a usar el SDK