Descripción general 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 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 .
Endpoints compatibles Chat y generación de texto Endpoint Método Descripción /v1/chat/completionsPOST Completions de chat compatibles con OpenAI /v1/messagesPOST API de mensajes compatible con Anthropic /v1/responsesPOST API de respuestas de OpenAI
Embeddings y Rerank Endpoint Método Descripción /v1/embeddingsPOST Crear embeddings de texto /v1/rerankPOST Reclasificar (Rerank) documentos
Imágenes Endpoint Método Descripción /v1/images/generationsPOST Generar imágenes a partir de texto /v1/images/editsPOST Editar imágenes
Audio Endpoint Método Descripción /v1/audio/speechPOST Texto a voz (TTS) /v1/audio/transcriptionsPOST Voz a texto (STT)
Video Endpoint Método Descripción /v1/videos/generationsPOST Crear tarea de generación de video /v1/videos/generations/{id}GET Obtener el estado de la tarea de video
Música Endpoint Método Descripción /v1/music/generationsPOST Crear tarea de generación de música /v1/music/generations/{id}GET Obtener el estado de la tarea de música
Generación 3D Endpoint Método Descripción /v1/3d/generationsPOST Crear tarea de generación de modelos 3D /v1/3d/generations/{id}GET Obtener el estado de la tarea 3D
Modelos Endpoint Método Descripción /v1/modelsGET Listar todos los modelos disponibles /v1/models/{model}GET Obtener información de un modelo específico
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.idIdentificador de canal utilizado channel.providerProveedor ascendente (openai, anthropic, etc.) channel.channelTypePLATFORM (LemonData) o PRIVATE (BYOK)cachedSi la respuesta se sirvió desde la caché retryCountNú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 (Rate Limits) Los límites de tasa se basan en roles y son configurables por los administradores. Valores por defecto:
Rol Solicitudes/min Usuario 60 Socio 300 VIP 1,000 Admin Ilimitado
Contacta con soporte para límites de tasa personalizados. Los valores exactos pueden variar según la configuración de la cuenta.
Los encabezados de límite de tasa se incluyen en todas las respuestas:
X-RateLimit-Limit: 60 X-RateLimit-Remaining: 55 X-RateLimit-Reset: 1234567890
Especificación OpenAPI
Especificación OpenAPI Descarga la especificación completa de OpenAPI 3.0
