Referencia de la API

Referencia completa para la API de LemonData

​

Generalidades

La API de LemonData es compatible con OpenAI, lo que significa que puedes usar el SDK oficial de OpenAI con solo cambiar la URL base. También admitimos formatos de solicitud nativos de Anthropic y Gemini.

​

URL Base

https://api.lemondata.cc

​

Autenticación

Todos los endpoints de la API requieren autenticación mediante un token Bearer:

Authorization: Bearer sk-your-api-key

Obtén tu clave de API desde el Dashboard.

Acerca del Playground interactivo: El playground en este sitio de documentación es solo para fines de demostración y no admite el ingreso de claves de API. Para probar la API, utiliza:

• cURL - Copia los comandos de ejemplo y reemplaza sk-your-api-key con tu clave real
• Postman - Importa nuestra especificación OpenAPI
• SDK - Utiliza el SDK de OpenAI/Anthropic con nuestra URL base

​

Endpoints Soportados

​

Chat y Generación de Texto

Endpoint	Método	Descripción
/v1/chat/completions	POST	Completions de chat compatibles con OpenAI
/v1/messages	POST	API de mensajes compatible con Anthropic
/v1/responses	POST	API de respuestas de OpenAI

​

Embeddings y Rerank

Endpoint	Método	Descripción
/v1/embeddings	POST	Crear embeddings de texto
/v1/rerank	POST	Reclasificar (Rerank) documentos

​

Imágenes

Endpoint	Método	Descripción
/v1/images/generations	POST	Generar imágenes a partir de texto
/v1/images/edits	POST	Editar imágenes
/v1/images/generations/{id}	GET	Ruta de estado de tarea de imagen para respuestas de imagen basadas en tareas

Algunos modelos de imagen pueden devolver resultados en línea, otros pueden devolver respuestas basadas en tareas y algunos pueden comportarse de ambas formas dependiendo de la ruta del proveedor asignada. Si la respuesta de creación incluye poll_url, síguela exactamente.

​

Audio

Endpoint	Método	Descripción
/v1/audio/speech	POST	Texto a voz (TTS)
/v1/audio/transcriptions	POST	Voz a texto (STT)

​

Video

Endpoint	Método	Descripción
/v1/videos/generations	POST	Crear tarea de generación de video
/v1/tasks/{id}	GET	Obtener el estado de la tarea asíncrona para trabajos de video
/v1/videos/generations/{id}	GET	Ruta de estado de tarea de video compatible con versiones anteriores (legacy)

Para nuevos clientes, se recomienda /v1/tasks/{id} y seguir la poll_url devuelta por las respuestas de creación. Mantén /v1/videos/generations/{id} solo por compatibilidad con versiones anteriores.

​

Tareas Asíncronas

Endpoint	Método	Descripción
/v1/tasks/{id}	GET	Endpoint unificado de estado de tareas asíncronas. Recomendado al seguir una poll_url devuelta

Este endpoint no se limita a video, música y 3D. Algunas tareas de imagen también pueden usar /v1/tasks/{id} como la ruta de sondeo (polling) canónica.

​

Música

Endpoint	Método	Descripción
/v1/music/generations	POST	Crear tarea de generación de música
/v1/music/generations/{id}	GET	Ruta de estado específica para música

Para nuevos clientes, prioriza la poll_url devuelta. Si necesitas un endpoint de estado de tarea fijo, usa /v1/tasks/{id}; mantén /v1/music/generations/{id} para rutas de compatibilidad específicas de música.

​

Generación 3D

Endpoint	Método	Descripción
/v1/3d/generations	POST	Crear tarea de generación de modelos 3D
/v1/3d/generations/{id}	GET	Ruta de estado específica para 3D

Para nuevos clientes, prioriza la poll_url devuelta. Si necesitas un endpoint de estado de tarea fijo, usa /v1/tasks/{id}; mantén /v1/3d/generations/{id} para rutas de compatibilidad específicas de 3D.

​

Modelos

Endpoint	Método	Descripción
/v1/models	GET	Listar todos los modelos disponibles
/v1/models/{model}	GET	Obtener información de un modelo específico

​

Gemini (v1beta)

Soporte nativo para el formato de la API de Google Gemini:

Endpoint	Método	Descripción
/v1beta/models/{model}:generateContent	POST	Generar contenido (formato Gemini)
/v1beta/models/{model}:streamGenerateContent	POST	Generar contenido en streaming (formato Gemini)

Los endpoints de Gemini admiten la autenticación mediante el parámetro de consulta ?key=, además del token Bearer estándar.

​

Formato de Respuesta

Todas las respuestas siguen un formato consistente:

​

Respuesta Exitosa

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

​

Transparencia de Enrutamiento

Todas las respuestas incluyen un campo _routing con información del canal:

{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}

Campo	Descripción
channel.id	Identificador de canal utilizado
channel.provider	Proveedor ascendente (openai, anthropic, etc.)
channel.channelType	PLATFORM (LemonData) o PRIVATE (BYOK)
cached	Si la respuesta fue servida desde la caché
retryCount	Número de intentos de reintento (si los hay)

​

Respuesta de Error

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

​

Límites de Tasa

Los límites de tasa (rate limits) se basan en roles y son configurables por los administradores. Valores por defecto:

Rol	Solicitudes/min
User	60
Partner	300
VIP	1,000

Contacta con soporte para límites de tasa personalizados. Los valores exactos pueden variar según la configuración de la cuenta.

Cuando se exceden los límites de tasa, la API devuelve un código de estado 429 con un encabezado Retry-After que indica cuánto tiempo se debe esperar.

​

Especificación OpenAPI

Especificación OpenAPI

Descarga la especificación completa de OpenAPI 3.0