API Documentationv2.0

Construye con la API de LectorAI

Integra traducción de libros con IA en tu aplicación. SDKs oficiales, webhooks y documentación completa.

99.9%

Uptime

<200ms

Latencia

REST

API

Documentación

Todo lo que necesitas para integrar LectorAI

Inicio Rápido

Traduce un libro en 3 pasos

1

Obtén tu API Key

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

2

Instala el SDK

npm install @lectorai/sdk

3

Sube y traduce

Usa el SDK para subir tu EPUB y recibir la traducción

Ver guía completa

SDKs Oficiales

Librerías mantenidas por el equipo de LectorAI

Node.js / TypeScript

@lectorai/sdk

npm install @lectorai/sdk
Ver documentación

Python

lectorai

pip install lectorai
Ver documentación

CLI Tool

lectorai-cli

npx lectorai translate book.epub
Ver documentación

Community API

Crea posts y comentarios desde CLI o tu aplicación

Nuevo
POST/api/community/posts

Crear un post desde terminal:

curl -X POST https://lectorai.com/api/community/posts \
  -H "Authorization: Bearer lector_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Mi post desde CLI",
    "content": "# Hola mundo\n\nEste es mi post.",
    "categorySlug": "tutoriales",
    "tagSlugs": ["cli", "api"],
    "status": "PUBLISHED"
  }'
POST/api/community/comments

Comentar en un post:

curl -X POST https://lectorai.com/api/community/comments \
  -H "Authorization: Bearer lector_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "postSlug": "mi-post-desde-cli",
    "content": "Excelente artículo!",
    "mood": "EXCITED"
  }'

Tip: Puedes usar categorySlug y tagSlugs en lugar de IDs para mayor facilidad desde CLI. Los moods disponibles son: EXCITED, LOVED, HAPPY, SAD, THUMBSY.

Translation Cache

Ahorra tokens reutilizando traducciones idénticas

Nuevo

Cómo funciona

El sistema genera un hash SHA-256 único basado en:

  • Texto original
  • Modelo de traducción (gpt-4o-mini, claude-haiku, etc.)
  • Idioma origen/destino
  • Términos del glosario

Si el hash ya existe, se devuelve la traducción cacheada sin llamar a la API de IA, ahorrando tokens y tiempo.

GET/api/translation-cache

Obtener estadísticas del cache:

curl https://lectorai.com/api/translation-cache \
  -H "Authorization: Bearer lector_xxx"

# Response:
{
  "totalEntries": 1234,
  "totalHits": 567,
  "totalTokensSaved": 89000,
  "estimatedSavings": 0.42,
  "hitRate": 31,
  "topModels": [
    { "model": "gpt-4o-mini", "entries": 800, "hits": 400 }
  ]
}

100%

Ahorro en duplicados

<10ms

Latencia cache hit

SHA-256

Hash único

Casos de uso: El cache es más efectivo cuando traduces el mismo libro varias veces (pruebas con diferentes modelos), libros con contenido repetitivo (manuales técnicos, documentación), o cuando usuarios diferentes traducen el mismo libro público.

¿Necesitas la referencia completa?

Explora todos los endpoints, parámetros y respuestas en nuestra especificación OpenAPI