Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

Response

object
string
Always list.
data
array
Array of model objects.Each model contains:
  • id (string): Model identifier
  • object (string): model
  • created (integer): Creation timestamp
  • owned_by (string): Model provider
  • lemondata.category (string): Public model category
  • lemondata.pricing_unit (string or null): Public pricing unit when available
  • lemondata.capability_flags (object or null): Public capability summary
  • lemondata.supported_operations (array or null): Public non-chat operations for the model
  • lemondata.pricing_provenance (object or null): Public pricing source metadata
  • lemondata.public_contract_summary (object or null): Lightweight non-chat discovery summary with only public_operations and request_endpoint
  • lemondata.agent_preferences (object): Only returned when recommended_for is present
GET /v1/models is optimized for discovery. Detail-only metadata such as capability_flags, pricing_provenance, and the full public_contract live on GET /v1/models/{model}.

Query Parameters

category
string
Optional public category filter. Supports chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, and translation.
Optional non-chat recommendation scene. Supports image, video, music, 3d, tts, stt, embedding, rerank, and translation.
provider
string
Optional provider filter such as openai, anthropic, google, or deepseek.
tag
string
Optional model tag filter such as chat, image, video, embedding, or translation.
When recommended_for is present, /v1/models sorts non-chat models by the latest cached 24-hour success-rate snapshot. Models with status = "insufficient_samples" remain visible but sort after scored models.
curl "https://api.lemondata.cc/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.4",
      "object": "model",
      "created": 1706000000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-6",
      "object": "model",
      "created": 1706000000,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-2.5-flash",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google"
    }
  ]
}

Filtering by Provider

# Get all OpenAI models
openai_models = [m for m in models.data if m.owned_by == "openai"]

# Get all Anthropic models
anthropic_models = [m for m in models.data if m.owned_by == "anthropic"]

Model Categories

ProviderExample Models
openaigpt-5.4, gpt-5.4-mini, gpt-5-mini, gpt-4o, dall-e-3
anthropicclaude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
googlegemini-3-pro-preview, gemini-3-flash-preview, gemini-2.5-pro
deepseekdeepseek-r1, deepseek-v3-2
xaigrok-4.1
moonshotkimi-k2.5
minimaxminimax-m2.1
metallama-3.3-70b, llama-3.1-405b

Agent Recommendation Example

Response
{
  "object": "list",
  "data": [
    {
      "id": "gemini-2.5-flash-image",
      "object": "model",
      "created": 1706000000,
      "owned_by": "google",
      "lemondata": {
        "category": "image",
        "pricing_unit": "per_request",
        "agent_preferences": {
          "image": {
            "preferred_rank": 1,
            "success_rate_24h": 0.98,
            "sample_count_24h": 423,
            "status": "ready",
            "updated_at": "2026-03-28T12:00:00.000Z",
            "basis": {
              "score_source": "clickhouse_24h",
              "channel_id": null,
              "physical_model": null
            }
          }
        }
      }
    }
  ]
}