List Models

Lists all available models

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.public_contract_summary (object or null): Public non-chat contract summary
• lemondata.agent_preferences (object): Non-chat recommendation snapshot keyed by scene

Query Parameters

category · string

Optional public category filter. Supports chat, image, video, audio, tts, stt, music, 3d, embedding, rerank, and translation.

recommended_for · string

Optional non-chat recommendation scene. Supports image, video, music, 3d, tts, stt, embedding, rerank, and 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

curl "https://api.lemondata.cc/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

Response

{
  "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

Provider	Example Models
openai	gpt-5.4, gpt-5.4-mini, gpt-5-mini, gpt-4o, dall-e-3
anthropic	claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
google	gemini-3-pro-preview, gemini-3-flash-preview, gemini-2.5-pro
deepseek	deepseek-r1, deepseek-v3-2
xai	grok-4.1
moonshot	kimi-k2.5
minimax	minimax-m2.1
meta	llama-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
            }
          }
        }
      }
    }
  ]
}