Saltar para o conteúdo principal
Este skill ensina seu agente de programação a integrar as 300+ APIs de IA da LemonData apenas descrevendo o que você precisa. Ele é empacotado como um skill compartilhado agent-first e funciona com qualquer agente de programação que suporte arquivos de skill ou regras.A API é Agent-First — mesmo que o agente adivinhe errado o nome de um modelo, a resposta de erro informa exatamente como corrigir isso.
Esta página documenta uma camada reutilizável de empacotamento de skill, e não uma superfície de compatibilidade de protocolo. Se você precisa de configuração de ponto de terminação, SDK ou cliente, use as páginas de integração dedicadas dessas ferramentas.

​
Como Funciona

  1. Você descreve o que precisa — “Quero usar GPT-4 no meu projeto Python”
  2. O agente chama a API — ele pode adivinhar um nome de modelo ou ponto de terminação
  3. Se algo der errado — a API retorna dicas estruturadas (did_you_mean, suggestions, retry_after)
  4. O agente se autocorrige — lê as dicas e tenta novamente com os parâmetros corretos
  5. Você recebe código funcional — normalmente na primeira ou segunda tentativa

​
Instalação

Use o comando de instalação canônico não interativo:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y
Isso instala o skill compartilhado lemondata-api-integration do repositório de skills da LemonData.Se sua ferramenta não suportar o instalador, copie a pasta skills/lemondata-api-integration/ do repositório para o diretório compartilhado de skills ou regras da sua ferramenta.

​
Verificar Instalação

Pergunte ao seu agente de programação: 
Quais skills estão disponíveis?
Se você vir lemondata-api-integration, a instalação foi bem-sucedida.

​
Obtenha sua API Key

1

Visite a LemonData

Acesse lemondata.cc
2

Faça login

Crie uma conta ou entre
3

Obtenha a API Key

Navegue até Dashboard → API Keys e crie uma nova chave
4

Copie a chave

Sua chave começa com sk-... — salve-a com segurança
Você não precisa configurar a API Key com antecedência. Quando usar o skill, o agente pedirá sua chave e a incluirá no código gerado.

​
Exemplos

​
Conclusão de Chat

Você diz: 
Quero usar GPT-4 no meu projeto Python
O agente gera: 
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)
Se o agente adivinhar um nome de modelo errado (ex.: gpt5), a API retorna: 
{
  "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."
  }
}
O agente lê did_you_mean, corrige o nome do modelo e tenta novamente — tudo automaticamente.

​
Geração de Imagens

Você diz: 
Generate images with Flux in Node.js
O agente chama a API de imagem, lida com erros e gera código completo com lógica de download e salvamento.

​
Reconhecimento de Fala

Você diz: 
Integrate speech-to-text in my app
O agente gera código com o ponto de terminação correto /v1/audio/transcriptions e tratamento de arquivo de áudio.

​
Recuperação de Erros Agent-First

Toda resposta de erro inclui dicas estruturadas que qualquer agente de programação pode interpretar. Veja a referência completa da API Agent-First para mais detalhes.
ErrorO que a API retornaO que o agente faz
Nome de modelo incorretodid_you_mean + suggestionsCorrige automaticamente e tenta novamente
Saldo insuficientebalance_usd + suggestions mais baratasMuda para um modelo acessível
Modelo indisponívelalternatives + retry_afterMuda para um modelo disponível
Rate limitedretry_after (segundos exatos)Aguarda e tenta novamente
Contexto muito longosuggestions com modelos maioresMuda para um modelo com contexto maior

​
Otimização de Endpoint Nativo

Quando você chama /v1/chat/completions com um modelo Claude ou Gemini, a API retorna cabeçalhos de otimização: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
O agente muda automaticamente para o ponto de terminação nativo para melhor desempenho (sem conversão de formato, thinking estendido, cache de prompt).

​
Descoberta de Modelos

Não é necessário procurar na documentação: 
# 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 Suportadas

TypeExemplos
ChatGPT-5.4, Claude, Gemini, DeepSeek
Geração de ImagensMidjourney, Flux, Stable Diffusion
Geração de VídeoSora, Runway, Kling, Luma AI
Geração de MúsicaSuno
Modelos 3DTripo3D
ÁudioText-to-Speech, Speech-to-Text
Embeddingstext-embedding-3
Rerankbce-reranker, qwen3-rerank

​
Boas Práticas

Segurança da API Key

Use variáveis de ambiente. Nunca faça commit de chaves no git nem as exponha em código frontend.

Gestão de Custos

Defina limites de uso no seu dashboard. Verifique error.balance_usd para monitorar custos programaticamente.

Seja Direto

Diga “Quero gerar imagens em Python” em vez de “A LemonData tem uma API de imagem?”

Descreva Seu Cenário

“Estou criando um chatbot com GPT-4” dá ao agente mais contexto do que “Use GPT-4”.

​
FAQ

Tente mencionar “LemonData” ou “LemonData API” na sua solicitação:
Quero integrar GPT-4 ao meu projeto usando LemonData
A API Agent-First da LemonData retorna dicas de erro estruturadas. Se o agente adivinhar um nome de modelo errado, o erro inclui did_you_mean com o nome correto e suggestions com alternativas. O agente lê isso e corrige automaticamente na próxima tentativa.
Qualquer agente de programação que suporte diretórios compartilhados de skills ou regras. Quando o instalador é suportado, npx skills add coloca automaticamente o skill compartilhado lemondata-api-integration no local detectado.
Execute o instalador novamente:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

​
Recursos

API Agent-First

Referência completa para dicas de erro estruturadas

Documentação da API

Referência completa da API

Modelos

Navegue por todos os mais de 300 modelos disponíveis

llms.txt

Visão geral da API legível por máquina para agentes de IA
Tem dúvidas? Consulte nossas GitHub Issues ou entre em contato com [email protected]