{"openapi":"3.1.0","info":{"title":"LiteLLM Model Catalog API","description":"REST API for LiteLLM's model catalog — pricing, context windows, and capability metadata for 2,500+ LLM models across all major providers.\n\n## Quick Start\n\n```bash\n# List all models (paginated)\ncurl https://models.litellm.ai/model_catalog\n\n# Get a specific model\ncurl https://models.litellm.ai/model_catalog/gpt-4o\n\n# Filter by provider\ncurl https://models.litellm.ai/model_catalog?provider=anthropic\n\n# Filter by capabilities\ncurl 'https://models.litellm.ai/model_catalog?supports_vision=true&supports_reasoning=true'\n```\n\n## Pricing Data\n\nCosts are per-token. Multiply by 1,000,000 for per-million-token pricing.\nData refreshes from LiteLLM's GitHub repository every 60 seconds.","version":"1.0.0"},"paths":{"/billing/checkout":{"post":{"tags":["Billing"],"summary":"Create a Stripe Checkout session for API access","description":"Returns a Stripe Checkout URL. After payment, you'll receive an API key.","operationId":"create_checkout_billing_checkout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutResponse"}}}}}}},"/billing/usage":{"get":{"tags":["Billing"],"summary":"Check your free-tier usage","description":"See how many requests you've used today (free tier, by IP).","operationId":"check_usage_billing_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreeTierResponse"}}}}}}},"/model_catalog":{"get":{"summary":"List the full LiteLLM model catalog","description":"Returns model pricing, context window sizes, and capability metadata from LiteLLM's built-in catalog. Supports filtering by provider, mode, model name pattern, and pagination.","operationId":"list_model_catalog_model_catalog_get","parameters":[{"name":"provider","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by provider (e.g. 'openai', 'anthropic', 'bedrock'). Case-insensitive.","title":"Provider"},"description":"Filter by provider (e.g. 'openai', 'anthropic', 'bedrock'). Case-insensitive."},{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by mode (e.g. 'chat', 'embedding', 'image_generation').","title":"Mode"},"description":"Filter by mode (e.g. 'chat', 'embedding', 'image_generation')."},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by model name. Supports substring match or regex (prefix with 're:').","title":"Model"},"description":"Filter by model name. Supports substring match or regex (prefix with 're:')."},{"name":"supports_vision","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Vision"}},{"name":"supports_function_calling","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Function Calling"}},{"name":"supports_reasoning","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Reasoning"}},{"name":"supports_audio_input","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Audio Input"}},{"name":"supports_audio_output","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Audio Output"}},{"name":"supports_prompt_caching","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Prompt Caching"}},{"name":"supports_response_schema","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Response Schema"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number (1-indexed)","default":1,"title":"Page"},"description":"Page number (1-indexed)"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Number of results per page (max 500)","default":50,"title":"Page Size"},"description":"Number of results per page (max 500)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelCatalogListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/model_catalog/{model_id}":{"get":{"summary":"Get a single model from the catalog","description":"Returns detailed information for a specific model by its exact ID.","operationId":"get_model_catalog_entry_model_catalog__model_id__get","parameters":[{"name":"model_id","in":"path","required":true,"schema":{"type":"string","title":"Model Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelCatalogEntry"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CheckoutResponse":{"properties":{"url":{"type":"string","title":"Url","description":"Stripe Checkout URL — redirect the user here"}},"type":"object","required":["url"],"title":"CheckoutResponse"},"FreeTierResponse":{"properties":{"ip_hash":{"type":"string","title":"Ip Hash"},"requests_today":{"type":"integer","title":"Requests Today"},"daily_limit":{"type":"integer","title":"Daily Limit"},"remaining":{"type":"integer","title":"Remaining"}},"type":"object","required":["ip_hash","requests_today","daily_limit","remaining"],"title":"FreeTierResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ModelCatalogEntry":{"properties":{"id":{"type":"string","title":"Id","description":"Canonical model identifier (e.g. 'gpt-4o')"},"object":{"type":"string","title":"Object","default":"model_catalog.entry"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"LiteLLM provider key (e.g. 'openai', 'azure')"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode","description":"Model mode: chat, embedding, completion, image_generation, etc."},"max_input_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Input Tokens"},"max_output_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Output Tokens"},"max_tokens":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Tokens","description":"Legacy combined token limit"},"input_cost_per_token":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Input Cost Per Token"},"output_cost_per_token":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Output Cost Per Token"},"cache_read_input_token_cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cache Read Input Token Cost"},"input_cost_per_audio_token":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Input Cost Per Audio Token"},"output_cost_per_reasoning_token":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Output Cost Per Reasoning Token"},"deprecation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deprecation Date","description":"ISO date when the model is deprecated (YYYY-MM-DD)"},"supports_function_calling":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Function Calling"},"supports_parallel_function_calling":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Parallel Function Calling"},"supports_vision":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Vision"},"supports_audio_input":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Audio Input"},"supports_audio_output":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Audio Output"},"supports_prompt_caching":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Prompt Caching"},"supports_reasoning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Reasoning"},"supports_response_schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Response Schema"},"supports_system_messages":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports System Messages"},"supports_web_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Supports Web Search"}},"additionalProperties":true,"type":"object","required":["id"],"title":"ModelCatalogEntry","description":"A single model in the catalog."},"ModelCatalogListResponse":{"properties":{"object":{"type":"string","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/ModelCatalogEntry"},"type":"array","title":"Data"},"total_count":{"type":"integer","title":"Total Count","description":"Total models matching the filters"},"has_more":{"type":"boolean","title":"Has More"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"}},"type":"object","required":["data","total_count","has_more","page","page_size"],"title":"ModelCatalogListResponse","description":"Stripe-style list response."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}