✨ Skill de Integración de la API de LemonData

Instala el skill compartido de integración de la API de LemonData para cualquier agente de programación, con recuperación de errores Agent-First.

Este skill le enseña a tu agente de programación cómo integrar las más de 300 APIs de IA de LemonData simplemente describiendo lo que necesitas. Está empaquetado como un único skill compartido agent-first y funciona con cualquier agente de programación que admita archivos de skills o reglas.

La API es Agent-First — incluso si el agente adivina incorrectamente el nombre de un modelo, la respuesta de error le indica exactamente cómo corregirlo.

Esta página documenta una capa reutilizable de empaquetado de skill, no una superficie de compatibilidad de protocolo. Si necesitas configuración de punto de conexión, SDK o cliente, usa las páginas de integración dedicadas para esas herramientas.

​

Cómo Funciona

1. Describes lo que necesitas — “Quiero usar GPT-4 en mi proyecto de Python”
2. El agente llama a la API — puede adivinar un nombre de modelo o punto de conexión
3. Si algo sale mal — la API devuelve pistas estructuradas (did_you_mean, suggestions, retry_after)
4. El agente se autocorrige — lee las pistas y vuelve a intentarlo con los parámetros correctos
5. Obtienes código funcional — normalmente en el primer o segundo intento

​

Instalación

Usa el comando de instalación canónico no interactivo:

npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

Esto instala el skill compartido lemondata-api-integration desde el repositorio de skills de LemonData.

Si tu herramienta no admite el instalador, copia la carpeta skills/lemondata-api-integration/ del repositorio en el directorio compartido de skills o reglas de tu herramienta.

​

Verificar la Instalación

Pregúntale a tu agente de programación:

¿Qué skills están disponibles?

Si ves lemondata-api-integration, la instalación fue exitosa.

​

Obtén tu API Key

1. Visita LemonData

   Ve a lemondata.cc

2. Inicia sesión

   Crea una cuenta o inicia sesión

3. Obtén la API Key

   Ve a Dashboard → API Keys y crea una nueva key

4. Copia la Key

   Tu key comienza con sk-... — guárdala de forma segura

No necesitas configurar la API Key por adelantado. Cuando uses el skill, el agente te pedirá tu key y la incluirá en el código generado.

​

Ejemplos

​

Chat Completion

Tú dices:

Quiero usar GPT-4 en mi proyecto de Python

El agente genera:

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.lemondata.cc/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

Si el agente adivina un nombre de modelo incorrecto (por ejemplo, gpt5), la API devuelve:

{
  "error": {
    "code": "model_not_found",
    "did_you_mean": "gpt-5.4",
    "suggestions": [{"id": "gpt-5.4"}, {"id": "gpt-5-mini"}],
    "hint": "Did you mean 'gpt-5.4'? Use GET https://api.lemondata.cc/v1/models to list all available models."
  }
}

El agente lee did_you_mean, corrige el nombre del modelo y vuelve a intentarlo — todo automáticamente.

​

Generación de Imágenes

Tú dices:

Generate images with Flux in Node.js

El agente llama a la API de imágenes, maneja los errores y genera código completo con lógica de descarga y guardado.

​

Reconocimiento de Voz

Tú dices:

Integrate speech-to-text in my app

El agente genera código con el punto de conexión correcto /v1/audio/transcriptions y manejo de archivos de audio.

​

Recuperación de Errores Agent-First

Cada respuesta de error incluye pistas estructuradas que cualquier agente de programación puede analizar. Consulta la referencia completa de la API Agent-First para obtener más detalles.

Error	Lo que devuelve la API	Lo que hace el agente
Nombre de modelo incorrecto	did_you_mean + suggestions	Corrige automáticamente y reintenta
Saldo insuficiente	balance_usd + suggestions más económicas	Cambia a un modelo asequible
Modelo no disponible	alternatives + retry_after	Cambia a un modelo disponible
Límite de tasa alcanzado	retry_after (segundos exactos)	Espera y reintenta
Contexto demasiado largo	suggestions con modelos más grandes	Cambia a un modelo con mayor contexto

​

Optimización de Endpoint Nativo

Cuando llamas a /v1/chat/completions con un modelo Claude o Gemini, la API devuelve headers de optimización:

X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages

El agente cambia automáticamente al punto de conexión nativo para obtener un mejor rendimiento (sin conversión de formato, pensamiento extendido, caché de prompts).

​

Descubrimiento de Modelos

No necesitas buscar en la documentación:

# Machine-readable API overview
curl https://api.lemondata.cc/llms.txt

# List models by category
curl "https://api.lemondata.cc/v1/models?category=chat" -H "Authorization: Bearer sk-KEY"
curl "https://api.lemondata.cc/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Filter by capability
curl "https://api.lemondata.cc/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​

Capacidades Compatibles

Tipo	Ejemplos
Chat	GPT-5.4, Claude, Gemini, DeepSeek
Generación de Imágenes	Midjourney, Flux, Stable Diffusion
Generación de Video	Sora, Runway, Kling, Luma AI
Generación de Música	Suno
Modelos 3D	Tripo3D
Audio	Text-to-Speech, Speech-to-Text
Embeddings	text-embedding-3
Rerank	bce-reranker, qwen3-rerank

​

Mejores Prácticas

Seguridad de la API Key

Usa variables de entorno. Nunca subas keys a git ni las expongas en código frontend.

Gestión de Costos

Establece límites de uso en tu dashboard. Revisa error.balance_usd para monitorear los costos de forma programática.

Sé Directo

Di “Quiero generar imágenes en Python” en lugar de “¿LemonData tiene una API de imágenes?”

Describe tu Escenario

“Estoy creando un chatbot con GPT-4” le da al agente más contexto que “Usa GPT-4”.

​

FAQ

¿El skill no se activa automáticamente?

Intenta mencionar “LemonData” o “LemonData API” en tu solicitud:

Quiero integrar GPT-4 en mi proyecto con LemonData

¿Cómo ayuda la API al agente a encontrar el modelo correcto?

La API Agent-First de LemonData devuelve pistas de error estructuradas. Si el agente adivina un nombre de modelo incorrecto, el error incluye did_you_mean con el nombre correcto y suggestions con alternativas. El agente las lee y se autocorrige en el siguiente intento.

¿Qué agentes de programación son compatibles?

Cualquier agente de programación que admita directorios compartidos de skills o reglas. Cuando el instalador es compatible, npx skills add coloca automáticamente el skill compartido lemondata-api-integration en la ubicación detectada.

¿Cómo actualizar el skill?

Vuelve a ejecutar el instalador:

npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

​

Recursos

API Agent-First

Referencia completa de las pistas de error estructuradas

Documentación de la API

Referencia completa de la API

Modelos

Explora los más de 300 modelos disponibles

llms.txt

Resumen legible por máquina de la API para agentes de IA

¿Tienes preguntas? Consulta nuestros GitHub Issues o contacta a [e-mail]