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
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
Endpoint Método Descrição /v1/chat/completionsPOST Completions de chat compatíveis com OpenAI /v1/messagesPOST API de mensagens compatível com Anthropic /v1/responsesPOST API de Respostas da OpenAI
Embeddings e Rerank
Endpoint Método Descrição /v1/embeddingsPOST Criar embeddings de texto /v1/rerankPOST Reordenar (Rerank) documentos
Imagens
Endpoint Método Descrição /v1/images/generationsPOST Gerar imagens a partir de texto /v1/images/editsPOST Editar imagens
Áudio
Endpoint Método Descrição /v1/audio/speechPOST Texto para fala (TTS) /v1/audio/transcriptionsPOST Fala para texto (STT)
Vídeo
Endpoint Método Descrição /v1/videos/generationsPOST Criar tarefa de geração de vídeo /v1/videos/generations/{id}GET Obter status da tarefa de vídeo
Música
Endpoint Método Descrição /v1/music/generationsPOST Criar tarefa de geração de música /v1/music/generations/{id}GET Obter status da tarefa de música
Geração 3D
Endpoint Método Descrição /v1/3d/generationsPOST Criar tarefa de geração de modelo 3D /v1/3d/generations/{id}GET Obter status da tarefa 3D
Modelos
Endpoint Método Descrição /v1/modelsGET Listar todos os modelos disponíveis /v1/models/{model}GET Obter 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
}
}
Campo Descriçã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ção Requisições/min Usuário 60 Parceiro 300 VIP 1,000 Admin Ilimitado
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