API Reference

Complete reference for the LemonData API

Overview

The LemonData API is OpenAI-compatible, which means you can use the official OpenAI SDK with just a base URL change. We also support native Anthropic and Gemini request formats.

Base URL

https://api.lemondata.cc

Authentication

All API endpoints require authentication using a Bearer token:

Authorization: Bearer sk-your-api-key

Get your API key from the Dashboard.

About the Interactive Playground: The playground on this documentation site is for demonstration purposes only and does not support entering API keys. To test the API, please use:

• cURL - Copy the example commands and replace sk-your-api-key with your actual key
• Postman - Import our OpenAPI spec
• SDK - Use OpenAI/Anthropic SDK with our base URL

Supported Endpoints

Chat & Text Generation

Endpoint	Method	Description
/v1/chat/completions	POST	OpenAI-compatible chat completions
/v1/messages	POST	Anthropic-compatible messages API
/v1/responses	POST	OpenAI Responses API

Embeddings & Rerank

Endpoint	Method	Description
/v1/embeddings	POST	Create text embeddings
/v1/rerank	POST	Rerank documents

Images

Endpoint	Method	Description
/v1/images/generations	POST	Generate images from text
/v1/images/edits	POST	Edit images
/v1/images/generations/{id}	GET	Image task status path for task-based image responses

Some image models may return results inline, some may return task-based responses, and some may behave either way depending on the routed provider path. If the create response includes poll_url, follow it exactly.

Audio

Endpoint	Method	Description
/v1/audio/speech	POST	Text-to-speech (TTS)
/v1/audio/transcriptions	POST	Speech-to-text (STT)

Video

Endpoint	Method	Description
/v1/videos/generations	POST	Create video generation task
/v1/tasks/{id}	GET	Get async task status for video jobs
/v1/videos/generations/{id}	GET	Legacy-compatible video task status path

For new clients, prefer /v1/tasks/{id} and follow the poll_url returned by create responses. Keep /v1/videos/generations/{id} only for backward compatibility.

Async Tasks

Endpoint	Method	Description
/v1/tasks/{id}	GET	Unified async task status endpoint. Recommended when following a returned poll_url

This endpoint is not limited to video, music, and 3D. Some image tasks may also use /v1/tasks/{id} as the canonical polling path.

Music

Endpoint	Method	Description
/v1/music/generations	POST	Create music generation task
/v1/music/generations/{id}	GET	Music-specific status path

For new clients, prefer the returned poll_url first. If you need a fixed task-status endpoint, use /v1/tasks/{id}; keep /v1/music/generations/{id} for music-specific compatibility paths.

3D Generation

Endpoint	Method	Description
/v1/3d/generations	POST	Create 3D model generation task
/v1/3d/generations/{id}	GET	3D-specific status path

For new clients, prefer the returned poll_url first. If you need a fixed task-status endpoint, use /v1/tasks/{id}; keep /v1/3d/generations/{id} for 3D-specific compatibility paths.

Models

Endpoint	Method	Description
/v1/models	GET	List all available models
/v1/models/{model}	GET	Get specific model info

Gemini (v1beta)

Native Google Gemini API format support:

Endpoint	Method	Description
/v1beta/models/{model}:generateContent	POST	Generate content (Gemini format)
/v1beta/models/{model}:streamGenerateContent	POST	Stream generate content (Gemini format)

Gemini endpoints support ?key= query parameter authentication in addition to standard Bearer token.

Response Format

All responses follow a consistent format:

Success Response

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

Routing Transparency

All responses include a _routing field with channel information:

{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}

Field	Description
channel.id	Channel identifier used
channel.provider	Upstream provider (openai, anthropic, etc.)
channel.channelType	PLATFORM (LemonData) or PRIVATE (BYOK)
cached	Whether response was served from cache
retryCount	Number of retry attempts (if any)

Error Response

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

Rate Limits

Rate limits are role-based and configurable by administrators. Default values:

Role	Requests/min
User	60
Partner	300
VIP	1,000

Contact support for custom rate limits. Exact values may vary by account configuration.

When rate limits are exceeded, the API returns a 429 status code with a Retry-After header indicating how long to wait.

OpenAPI Specification

OpenAPI Spec

Download the complete OpenAPI 3.0 specification