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 apenas alterando a URL base. Também oferecemos suporte aos formatos de requisição nativos da Anthropic e Gemini.

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 no Dashboard.

Endpoints Suportados

Chat e Geração de Texto

EndpointMétodoDescrição
/v1/chat/completionsPOSTCompletions de chat compatíveis com OpenAI
/v1/messagesPOSTAPI de mensagens compatível com Anthropic
/v1/responsesPOSTAPI de Respostas da OpenAI

Embeddings e Rerank

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

Imagens

EndpointMétodoDescrição
/v1/images/generationsPOSTGerar imagens a partir de texto
/v1/images/editsPOSTEditar imagens

Áudio

EndpointMétodoDescrição
/v1/audio/speechPOSTTexto para fala (TTS)
/v1/audio/transcriptionsPOSTFala para texto (STT)

Vídeo

EndpointMétodoDescrição
/v1/videos/generationsPOSTCriar tarefa de geração de vídeo
/v1/videos/generations/{id}GETObter status da tarefa de vídeo

Música

EndpointMétodoDescrição
/v1/music/generationsPOSTCriar tarefa de geração de música
/v1/music/generations/{id}GETObter status da tarefa de música

Geração 3D

EndpointMétodoDescrição
/v1/3d/generationsPOSTCriar tarefa de geração de modelo 3D
/v1/3d/generations/{id}GETObter status da tarefa 3D

Modelos

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

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 servida a partir do cache
retryCountNúmero de tentativas de reenvio (se houver)

Resposta de Erro

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

Limites de Taxa (Rate Limits)

Os limites de taxa são baseados em funções e configuráveis por administradores. Valores padrão:
FunçãoRequisições/min
Usuário60
Parceiro300
VIP1,000
AdminIlimitado
Entre em contato com o suporte para limites de taxa personalizados. Os valores exatos podem variar conforme a configuração da conta.
Os cabeçalhos de limite de taxa estão incluídos em todas as respostas:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1234567890

Especificação OpenAPI

Especificação OpenAPI

Baixe a especificação completa do OpenAPI 3.0