Saltar para o conteúdo principal

​
Visão Geral

A API LemonData é compatível com OpenAI, o que significa que você pode usar o SDK oficial da OpenAI com apenas uma alteração na URL base. Para a maioria das integrações, comece com POST /v1/chat/completions. Também suportamos formatos de requisição nativos Anthropic e Gemini, além de POST /v1/responses como um caminho opcional avançado.

​
URL Base

https://api.lemondata.cc

​
Autenticação

Todos os endpoints da API exigem autenticação usando um token Bearer: 
Authorization: Bearer sk-your-api-key
Obtenha sua chave de API a partir do Dashboard.
Sobre o Playground Interativo: O playground neste site de documentação é apenas para demonstração e não suporta a inserção de chaves de API. Para testar a API, por favor utilize:
  • cURL - Copie os comandos de exemplo e substitua sk-your-api-key pela sua chave real
  • Postman - Importe nossa OpenAPI spec
  • SDK - Use o SDK da OpenAI/Anthropic com nossa URL base

​
Endpoints Suportados

​
Chat & Geração de Texto

EndpointMétodoDescrição
/v1/chat/completionsPOSTChat completions compatível com OpenAI
/v1/messagesPOSTAPI de mensagens compatível com Anthropic
/v1/responsesPOSTOpenAI Responses API

​
Embeddings & Rerank

EndpointMétodoDescrição
/v1/embeddingsPOSTCriar embeddings de texto
/v1/rerankPOSTReordenar documentos

​
Imagens

EndpointMétodoDescrição
/v1/images/generationsPOSTGerar imagens a partir de texto
/v1/images/editsPOSTEditar imagens
/v1/images/generations/{id}GETCaminho de status de tarefa para respostas de imagem baseadas em tarefas
Alguns modelos de imagem podem retornar resultados inline, outros podem retornar respostas baseadas em tarefas, e alguns podem se comportar de ambas as formas dependendo do provedor roteado. Se a resposta de criação incluir poll_url, siga-a exatamente.

​
Áudio

EndpointMétodoDescrição
/v1/audio/speechPOSTText-to-speech (TTS)
/v1/audio/transcriptionsPOSTSpeech-to-text (STT)

​
Vídeo

EndpointMétodoDescrição
/v1/videos/generationsPOSTCriar tarefa de geração de vídeo
/v1/tasks/{id}GETObter status de tarefa assíncrona para jobs de vídeo
/v1/videos/generations/{id}GETCaminho de status de tarefa compatível com legados para vídeo
Para novos clientes, prefira /v1/tasks/{id} e siga o poll_url retornado pelas respostas de criação. Mantenha /v1/videos/generations/{id} apenas para compatibilidade retroativa.

​
Tarefas Assíncronas

EndpointMétodoDescrição
/v1/tasks/{id}GETEndpoint unificado de status de tarefa assíncrona. Recomendado ao seguir um poll_url retornado
Este endpoint não se limita a vídeo, música e 3D. Algumas tarefas de imagem também podem usar /v1/tasks/{id} como o caminho canônico de polling.

​
Música

EndpointMétodoDescrição
/v1/music/generationsPOSTCriar tarefa de geração de música
/v1/music/generations/{id}GETCaminho de status específico para música
Para novos clientes, prefira primeiro o poll_url retornado. Se você precisar de um endpoint fixo de status de tarefa, use /v1/tasks/{id}; mantenha /v1/music/generations/{id} para caminhos de compatibilidade específicos de música.

​
Geração 3D

EndpointMétodoDescrição
/v1/3d/generationsPOSTCriar tarefa de geração de modelo 3D
/v1/3d/generations/{id}GETCaminho de status específico para 3D
Para novos clientes, prefira primeiro o poll_url retornado. Se você precisar de um endpoint fixo de status de tarefa, use /v1/tasks/{id}; mantenha /v1/3d/generations/{id} para caminhos de compatibilidade específicos de 3D.

​
Modelos

EndpointMétodoDescrição
/v1/modelsGETListar todos os modelos disponíveis
/v1/models/{model}GETObter informações de um modelo específico

​
Gemini (v1beta)

Suporte nativo ao formato da API Google Gemini:
EndpointMétodoDescrição
/v1beta/models/{model}:generateContentPOSTGerar conteúdo (formato Gemini)
/v1beta/models/{model}:streamGenerateContentPOSTGerar conteúdo em stream (formato Gemini)
Os endpoints Gemini suportam autenticação por parâmetro de query ?key= além do token Bearer padrão.

​
Formato de Resposta

Todas as respostas seguem um formato consistente:

​
Resposta de Sucesso

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

​
Transparência de Roteamento

Todas as respostas incluem um campo _routing com informações do canal: 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
CampoDescrição
channel.idIdentificador do canal utilizado
channel.providerProvedor upstream (openai, anthropic, etc.)
channel.channelTypePLATFORM (LemonData) ou PRIVATE (BYOK)
cachedSe a resposta foi fornecida a partir do cache
retryCountNúmero de tentativas de repetição (se houver)

​
Resposta de Erro

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

​
Limites de Taxa

Os limites de taxa são baseados em função e configuráveis por administradores. Valores padrão:
FunçãoRequisições/min
Usuário60
Parceiro300
VIP1.000
Contate o suporte para limites de taxa personalizados. Valores exatos podem variar conforme a configuração da conta.
Quando os limites de taxa são excedidos, a API retorna um código de status 429 com um cabeçalho Retry-After indicando quanto tempo esperar.

​
Especificação OpenAPI

Especificação OpenAPI

Baixe a especificação completa OpenAPI 3.0