{"openapi":"3.0.0","info":{"title":"CloudPrice AI Models API","version":"1.0","description":"Free public API for AI model specs, pricing, benchmarks and cost calculation across 1000+ AI models (OpenAI, Anthropic, Google, Bedrock, Azure, Mistral). No API key required."},"servers":[{"url":"https://ai.cloudprice.net/api/v1","description":"AI Models API"}],"externalDocs":{"description":"CloudPrice AI API docs","url":"https://cloudprice.net/models/api"},"tags":[{"name":"AI Models","description":"Model specs, catalog, similar / compare."},{"name":"AI Pricing","description":"Provider × tier × region × dimension pricing matrix and history."},{"name":"AI Cost Calculator","description":"Estimate cost for one or many models from token usage."},{"name":"AI Benchmarks","description":"Benchmark metrics and per-model leaderboards."},{"name":"AI Providers","description":"Provider catalog and per-provider model lists."}],"paths":{"/benchmarks/{slug}/leaderboard":{"get":{"summary":"Get benchmark leaderboard","description":"Returns a ranked leaderboard for a specific benchmark metric.\nValid slugs: intelligence_index, coding_index, math_index, mmlu_pro, gpqa, hle,\nlivecodebench, scicode, math_500, aime, aime_25, ifbench, lcr,\nterminalbench_hard, tau2, output_tps, ttft_seconds, elo.\n","tags":["AI Benchmarks"],"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"},"description":"Benchmark metric slug.","example":"intelligence_index"},{"in":"query","name":"type","schema":{"type":"string"},"description":"Filter by model type."},{"in":"query","name":"creator","schema":{"type":"string"},"description":"Comma-separated creator names."},{"in":"query","name":"page_size","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Number of entries per page."},{"in":"query","name":"next_token","schema":{"type":"string"},"description":"Cursor token for pagination."}],"responses":{"200":{"description":"Leaderboard entries","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/LeaderboardEntry"}},"pagination":{"$ref":"#/components/schemas/PaginationInfo"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Unknown benchmark metric"},"429":{"description":"Rate limited"}}}},"/benchmarks":{"get":{"summary":"List available benchmark types","description":"Returns all benchmark metrics with metadata, including model counts.","tags":["AI Benchmarks"],"responses":{"200":{"description":"Benchmark types","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BenchmarkType"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"429":{"description":"Rate limited"}}}},"/calculate":{"get":{"summary":"Bulk cost calculation (GET)","description":"Calculates cost for the same usage scenario across multiple models.\nModels are resolved via the universal resolver (accepts any ID type).\nResults are sorted cheapest first.\n","tags":["AI Cost Calculator"],"parameters":[{"in":"query","name":"models","required":true,"schema":{"type":"string"},"description":"Comma-separated model IDs (1-50 models).","example":"claude-sonnet-4,gpt-4o,gemini-2.5-pro"},{"in":"query","name":"provider","schema":{"type":"string"},"description":"Preferred provider ID. If omitted, cheapest is selected per model."},{"in":"query","name":"tier","schema":{"type":"string","default":"standard"},"description":"Pricing tier."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."},{"in":"query","name":"input_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0}},{"in":"query","name":"output_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0}},{"in":"query","name":"reasoning_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0}},{"in":"query","name":"cache_read_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"description":"Tokens served from the prompt cache (typically discounted)."},{"in":"query","name":"cache_write_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"description":"Tokens written to the prompt cache (often charged at a premium over input)."},{"in":"query","name":"images","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}},{"in":"query","name":"audio_seconds","schema":{"type":"number","minimum":0,"maximum":1000000,"default":0}},{"in":"query","name":"calls","schema":{"type":"integer","minimum":1,"maximum":10000000,"default":1},"description":"Number of API calls (cost multiplier)."}],"responses":{"200":{"description":"Bulk cost results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"currency":{"type":"string"},"calls":{"type":"integer"},"usage":{"type":"object","additionalProperties":{"type":"number"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/BulkCostResult"}},"unresolved":{"type":"array","description":"Input IDs that could not be resolved to any model","items":{"type":"string"}},"no_pricing":{"type":"array","description":"Canonical model IDs that resolved successfully but have no pricing for the given filters","items":{"type":"string"}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"400":{"description":"Validation error"},"429":{"description":"Rate limited"}}},"post":{"summary":"Bulk cost calculation (POST)","description":"Same as GET but accepts a JSON body. The `models` field accepts either\na comma-separated string or an array of strings.\n","tags":["AI Cost Calculator"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["models"],"properties":{"models":{"oneOf":[{"type":"string","description":"Comma-separated model IDs","example":"claude-sonnet-4,gpt-4o"},{"type":"array","items":{"type":"string"},"description":"Array of model IDs","example":["claude-sonnet-4","gpt-4o"]}]},"provider":{"type":"string"},"tier":{"type":"string","default":"standard"},"currency":{"type":"string","default":"USD"},"input_tokens":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"output_tokens":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"reasoning_tokens":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"cache_read_tokens":{"type":"integer","minimum":0,"maximum":100000000,"default":0,"description":"Tokens served from the prompt cache."},"cache_write_tokens":{"type":"integer","minimum":0,"maximum":100000000,"default":0,"description":"Tokens written to the prompt cache."},"images":{"type":"integer","minimum":0,"maximum":100000,"default":0},"audio_seconds":{"type":"number","minimum":0,"maximum":1000000,"default":0},"calls":{"type":"integer","minimum":1,"maximum":10000000,"default":1,"description":"Number of API calls (cost multiplier)."}}}}}},"responses":{"200":{"description":"Bulk cost results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"currency":{"type":"string"},"calls":{"type":"integer"},"usage":{"type":"object","additionalProperties":{"type":"number"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/BulkCostResult"}},"unresolved":{"type":"array","items":{"type":"string"}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"400":{"description":"Validation error"},"413":{"description":"Request body too large (max 64 KB)"},"429":{"description":"Rate limited"}}}},"/models/{id}/benchmarks":{"get":{"summary":"Get benchmark scores for a model","description":"Returns all benchmark scores grouped by source, with rank and percentile information.","tags":["AI Benchmarks"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Model ID (any ID type accepted)."}],"responses":{"200":{"description":"Benchmark scores","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ModelBenchmarks"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Model not found"},"409":{"description":"Multiple matches"},"429":{"description":"Rate limited"}}}},"/models/{id}/compare":{"get":{"summary":"Compare pricing across models","description":"Compares pricing for the base model against up to 4 other models, across selected dimensions and providers.","tags":["AI Pricing"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Base model ID."},{"in":"query","name":"with","required":true,"schema":{"type":"string"},"description":"Comma-separated model IDs to compare against (1-4 models)."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."},{"in":"query","name":"dimensions","schema":{"type":"string","default":"input,output"},"description":"Comma-separated price dimensions to compare."},{"in":"query","name":"tier","schema":{"type":"string","default":"standard"},"description":"Pricing tier."},{"in":"query","name":"provider","schema":{"type":"string"},"description":"Comma-separated provider IDs to filter."}],"responses":{"200":{"description":"Pricing comparison","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"currency":{"type":"string"},"models":{"type":"array","items":{"type":"object","properties":{"model_id":{"type":"string"},"display_name":{"type":"string"},"prices_by_provider":{"type":"array","items":{"type":"object","properties":{"provider_id":{"type":"string"},"provider_name":{"type":"string"},"prices":{"type":"object","additionalProperties":{"type":"object","properties":{"price":{"type":"number"},"unit":{"type":"string"}}}}}}}}}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"400":{"description":"Validation error (e.g. more than 5 models total)"},"404":{"description":"Model not found"},"409":{"description":"Multiple matches"},"429":{"description":"Rate limited"}}}},"/models/{id}/pricing/calculate":{"get":{"summary":"Calculate cost for a single model","description":"Calculates the cost of a usage scenario for a specific model.\nReturns breakdown by dimension, chosen provider, and cheaper alternatives.\n","tags":["AI Cost Calculator"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Model ID (any ID type accepted)."},{"in":"query","name":"provider","schema":{"type":"string"},"description":"Filter to a specific provider. If omitted, all providers are included."},{"in":"query","name":"tier","schema":{"type":"string"},"description":"Filter to a specific pricing tier (e.g. standard, batch, flex, priority, latency_optimized). If omitted, all tiers are returned."},{"in":"query","name":"region","schema":{"type":"string"},"description":"Filter to a specific region (e.g. global, us-east-1, eu-west-1). If omitted, all regions are returned."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."},{"in":"query","name":"input_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"description":"Number of input tokens."},{"in":"query","name":"output_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"description":"Number of output tokens."},{"in":"query","name":"reasoning_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"description":"Number of reasoning/thinking tokens."},{"in":"query","name":"cache_read_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"description":"Number of tokens served from the prompt cache (typically billed at a discount)."},{"in":"query","name":"cache_write_tokens","schema":{"type":"integer","minimum":0,"maximum":100000000,"default":0},"description":"Number of tokens written to the prompt cache (often billed at a premium over the input rate)."},{"in":"query","name":"images","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0},"description":"Number of images."},{"in":"query","name":"audio_seconds","schema":{"type":"number","minimum":0,"maximum":1000000,"default":0},"description":"Audio duration in seconds."},{"in":"query","name":"calls","schema":{"type":"integer","minimum":1,"maximum":10000000,"default":1},"description":"Number of API calls (multiplier for total cost)."}],"responses":{"200":{"description":"Cost calculation result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"model_id":{"type":"string"},"currency":{"type":"string"},"calls":{"type":"integer"},"usage":{"type":"object","description":"Effective usage quantities per dimension","additionalProperties":{"type":"number"}},"best":{"description":"Overall cheapest option across all tiers and regions","$ref":"#/components/schemas/CostOption"},"best_by_tier":{"type":"object","description":"Cheapest option per tier (e.g. standard, batch, flex)","additionalProperties":{"$ref":"#/components/schemas/CostOption"}},"options":{"type":"array","description":"All available options sorted cheapest first","items":{"$ref":"#/components/schemas/CostOption"}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Model not found"},"409":{"description":"Multiple matches"},"429":{"description":"Rate limited"}}}},"/models/{id}/pricing/history":{"get":{"summary":"Get price history for a model","description":"Returns historical pricing data points grouped by provider and dimension. Default range is last 90 days.","tags":["AI Pricing"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Model ID (any ID type accepted)."},{"in":"query","name":"provider","schema":{"type":"string"},"description":"Comma-separated provider IDs to filter."},{"in":"query","name":"dimension","schema":{"type":"string","default":"input,output"},"description":"Comma-separated price dimensions."},{"in":"query","name":"tier","schema":{"type":"string","default":"standard"},"description":"Pricing tier."},{"in":"query","name":"from","schema":{"type":"string","format":"date"},"description":"Start date (ISO format). Defaults to 90 days ago."},{"in":"query","name":"to","schema":{"type":"string","format":"date"},"description":"End date (ISO format). Defaults to today."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."}],"responses":{"200":{"description":"Price history","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ModelPriceHistory"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Model not found"},"409":{"description":"Multiple matches"},"429":{"description":"Rate limited"}}}},"/models/{id}/pricing":{"get":{"summary":"Get full multi-dimensional pricing for a model","description":"Returns all pricing tiers and dimensions across all providers, with currency conversion.","tags":["AI Pricing"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Model ID (any ID type accepted)."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."},{"in":"query","name":"provider","schema":{"type":"string"},"description":"Comma-separated provider IDs to filter."},{"in":"query","name":"tier","schema":{"type":"string"},"description":"Comma-separated pricing tiers to filter."},{"in":"query","name":"dimension","schema":{"type":"string"},"description":"Comma-separated pricing dimensions to filter (e.g. input,output)."},{"in":"query","name":"region","schema":{"type":"string"},"description":"Comma-separated regions to filter (e.g. global,us,eu)."}],"responses":{"200":{"description":"Pricing data","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ModelPricing"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Model not found"},"409":{"description":"Multiple matches"},"429":{"description":"Rate limited"}}}},"/models/{id}":{"get":{"summary":"Get a single AI model by any ID","description":"Universal model resolver — accepts canonical ID, LiteLLM ID, Artificial Analysis ID,\nsource ID, or fuzzy name. Returns the model with optional sideloads.\nReturns 409 if the input matches multiple models.\n`include=pricing` sideloads `pricing.summary` and the full `pricing` matrix.\n","tags":["AI Models"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Model ID (canonical, litellm, aa, source, or fuzzy name).","example":"claude-sonnet-4"},{"in":"query","name":"include","schema":{"type":"string"},"description":"Comma-separated sideloads (pricing, benchmarks)."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."}],"responses":{"200":{"description":"Model found","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AIModel"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Model not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Multiple models match the given ID","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"multiple_matches"},"message":{"type":"string"},"details":{"type":"object","properties":{"candidates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":"string"},"match_type":{"type":"string"}}}}}}}}}}}}},"429":{"description":"Rate limited"}}}},"/models/{id}/similar":{"get":{"summary":"Get similar models","description":"Returns models similar to the given one, based on type and context window. Sorted by provider count.","tags":["AI Models"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Model ID (any ID type accepted)."},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Maximum number of similar models to return."},{"in":"query","name":"strategy","schema":{"type":"string","enum":["balanced","capability","price","performance"],"default":"balanced"},"description":"Similarity strategy."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."}],"responses":{"200":{"description":"Similar models","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AIModel"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Model not found"},"409":{"description":"Multiple matches"},"429":{"description":"Rate limited"}}}},"/models":{"get":{"summary":"List, search, or get options for AI models","description":"Multi-purpose endpoint controlled by the `view` parameter:\n- **list** (default) — paginated model listing with filtering, sorting, and optional sideloads\n- **options** — faceted filter options (types, creators, families, providers, etc.)\n- **typeahead** — lightweight search suggestions for autocomplete\n- **resolve** — batch-resolve arbitrary model IDs to canonical IDs\n","tags":["AI Models"],"parameters":[{"in":"query","name":"view","schema":{"type":"string","enum":["list","options","typeahead","resolve"],"default":"list"},"description":"Response mode."},{"in":"query","name":"ids","schema":{"type":"string"},"description":"Comma-separated model IDs for batch lookup (max 10) or resolve (max 50)."},{"in":"query","name":"type","schema":{"type":"string","default":"all"},"description":"Filter by model type (e.g. chat, embedding, image)."},{"in":"query","name":"creator","schema":{"type":"string"},"description":"Comma-separated creator names."},{"in":"query","name":"family","schema":{"type":"string"},"description":"Comma-separated model families."},{"in":"query","name":"tier","schema":{"type":"string"},"description":"Comma-separated pricing tiers."},{"in":"query","name":"capability","schema":{"type":"string"},"description":"Comma-separated capability keys (e.g. tool_use,vision)."},{"in":"query","name":"provider","schema":{"type":"string"},"description":"Comma-separated provider IDs."},{"in":"query","name":"has_pricing","schema":{"type":"boolean"},"description":"Filter to models with/without pricing data."},{"in":"query","name":"deprecated","schema":{"type":"boolean","default":false},"description":"Include deprecated models."},{"in":"query","name":"min_context","schema":{"type":"integer"},"description":"Minimum context window size."},{"in":"query","name":"max_context","schema":{"type":"integer"},"description":"Maximum context window size."},{"in":"query","name":"q","schema":{"type":"string","maxLength":200},"description":"Search query. Prefix with `/` for regex. Used for list filtering and typeahead."},{"in":"query","name":"sort","schema":{"type":"string","default":"-intelligence_index_rank"},"description":"Sort field. Prefix with `-` for descending. Supports model fields, price fields (input_price, output_price), and benchmark ranks (*_rank)."},{"in":"query","name":"include","schema":{"type":"string"},"description":"Comma-separated sideloads (pricing, benchmarks)."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD","minLength":3,"maxLength":3},"description":"ISO 4217 currency code for price conversion."},{"in":"query","name":"page_size","schema":{"type":"integer","minimum":1,"maximum":1000,"default":50},"description":"Number of items per page."},{"in":"query","name":"next_token","schema":{"type":"string"},"description":"Cursor token for pagination."}],"responses":{"200":{"description":"Successful response (shape varies by `view`)","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"view=list (paginated)","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AIModel"}},"pagination":{"$ref":"#/components/schemas/PaginationInfo"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},{"type":"object","description":"view=options","properties":{"data":{"$ref":"#/components/schemas/ModelsOptions"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},{"type":"object","description":"view=typeahead","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TypeaheadEntry"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},{"type":"object","description":"view=resolve","properties":{"data":{"type":"object","properties":{"resolved":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/ResolvedId"}},"unresolved":{"type":"array","items":{"type":"string"}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Rate limited"}}}},"/providers/{id}/models":{"get":{"summary":"List models for a specific provider","description":"Returns a paginated list of AI models available from the given provider. Supports the same filters as the main models endpoint.","tags":["AI Providers"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Provider ID.","example":"openai"},{"in":"query","name":"type","schema":{"type":"string","default":"all"},"description":"Filter by model type."},{"in":"query","name":"creator","schema":{"type":"string"},"description":"Comma-separated creator names."},{"in":"query","name":"q","schema":{"type":"string","maxLength":200},"description":"Search query."},{"in":"query","name":"sort","schema":{"type":"string","default":"-intelligence_index_rank"},"description":"Sort field."},{"in":"query","name":"include","schema":{"type":"string"},"description":"Comma-separated sideloads (default pricing)."},{"in":"query","name":"currency","schema":{"type":"string","default":"USD"},"description":"ISO 4217 currency code."},{"in":"query","name":"page_size","schema":{"type":"integer","minimum":1,"maximum":1000,"default":50},"description":"Number of items per page."},{"in":"query","name":"next_token","schema":{"type":"string"},"description":"Cursor token for pagination."}],"responses":{"200":{"description":"Paginated model list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AIModel"}},"pagination":{"$ref":"#/components/schemas/PaginationInfo"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Provider not found"},"429":{"description":"Rate limited"}}}},"/providers/{id}":{"get":{"summary":"Get a single provider","description":"Returns detailed information about a specific AI model provider.","tags":["AI Providers"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Provider ID.","example":"openai"}],"responses":{"200":{"description":"Provider details","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AIProvider"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"404":{"description":"Provider not found"},"429":{"description":"Rate limited"}}}},"/providers":{"get":{"summary":"List AI model providers","description":"Returns all providers with filtering by capabilities, tags, and sorting.","tags":["AI Providers"],"parameters":[{"in":"query","name":"has_models","schema":{"type":"boolean"},"description":"Filter to providers that have models."},{"in":"query","name":"has_pricing","schema":{"type":"boolean"},"description":"Filter to providers that have pricing data."},{"in":"query","name":"hosts_platform","schema":{"type":"boolean"},"description":"Filter to providers that host an inference platform."},{"in":"query","name":"own_models","schema":{"type":"boolean"},"description":"Filter to providers that create their own models."},{"in":"query","name":"tag","schema":{"type":"string"},"description":"Comma-separated tags to filter by."},{"in":"query","name":"sort","schema":{"type":"string","default":"name"},"description":"Sort field."}],"responses":{"200":{"description":"List of providers","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AIProvider"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}}}}},"429":{"description":"Rate limited"}}}}},"components":{"schemas":{"AIModel":{"type":"object","description":"AI model with metadata, capabilities, and optional sideloads","properties":{"id":{"type":"string","example":"claude-sonnet-4"},"name":{"type":"string"},"display_name":{"type":"string","example":"Claude Sonnet 4"},"description":{"type":"string"},"creator":{"type":"string","example":"Anthropic"},"family":{"type":"string","example":"Claude"},"tier":{"type":"string","example":"standard"},"version":{"type":"string"},"type":{"type":"string","enum":["chat","embedding","image","audio","video","code","moderation","reranker"]},"size_in_bn":{"type":"number","nullable":true},"modalities":{"type":"object","properties":{"input":{"type":"array","items":{"type":"string"}},"output":{"type":"array","items":{"type":"string"}}}},"context_window":{"type":"integer","nullable":true,"example":200000},"max_output_tokens":{"type":"integer","nullable":true},"tool_use_system_prompt_tokens":{"type":"integer"},"output_vector_sizes":{"type":"array","items":{"type":"integer"}},"knowledge_cutoff":{"type":"string","nullable":true},"training_data_cutoff":{"type":"string","nullable":true},"supported_reasoning_efforts":{"type":"array","items":{"type":"string"}},"tokenizer":{"type":"string","nullable":true},"capabilities":{"type":"object","additionalProperties":{"type":"boolean"}},"release_date":{"type":"string","format":"date","nullable":true},"earliest_deprecation_date":{"type":"string","format":"date","nullable":true},"deprecated":{"type":"boolean"},"has_pricing":{"type":"boolean"},"provider_count":{"type":"integer"},"ids":{"$ref":"#/components/schemas/ModelIds"},"hf_likes":{"type":"integer","nullable":true},"hf_downloads":{"type":"integer","nullable":true},"hf_downloads_all_time":{"type":"integer","nullable":true},"hf_trending_score":{"type":"number","nullable":true},"pricing":{"$ref":"#/components/schemas/ModelPricing"},"benchmarks":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/BenchmarkScore"}},"resolved_from":{"type":"object","properties":{"input_id":{"type":"string"},"match_type":{"type":"string"}}},"updated_at":{"type":"string"}}},"AIProvider":{"type":"object","properties":{"id":{"type":"string","example":"openai"},"name":{"type":"string","example":"OpenAI"},"description":{"type":"string"},"url":{"type":"string","nullable":true},"api_base_url":{"type":"string","nullable":true},"docs_url":{"type":"string","nullable":true},"pricing_url":{"type":"string","nullable":true},"own_models":{"type":"boolean"},"hosts_platform":{"type":"boolean"},"openai_compatible":{"type":"boolean"},"litellm_provider":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"modalities":{"type":"array","items":{"type":"string"}},"model_count":{"type":"integer"},"priced_model_count":{"type":"integer"},"pricing_tiers":{"type":"array","items":{"type":"string"}},"pricing_dimensions":{"type":"array","items":{"type":"string"}},"icon_url":{"type":"string"}}},"ApiErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object"}}},"meta":{"type":"object","properties":{"request_id":{"type":"string"}}}}},"ApiMeta":{"type":"object","properties":{"updated_at":{"type":"string"},"request_id":{"type":"string","format":"uuid"},"execution_ms":{"type":"integer"}}},"BenchmarkScore":{"type":"object","properties":{"value":{"type":"number"},"rank":{"type":"integer"},"total":{"type":"integer"},"percentile":{"type":"number"}}},"BenchmarkType":{"type":"object","properties":{"slug":{"type":"string","example":"intelligence_index"},"label":{"type":"string","example":"Intelligence"},"description":{"type":"string"},"source":{"type":"string"},"higher_is_better":{"type":"boolean"},"model_count":{"type":"integer"}}},"BulkCostResult":{"type":"object","properties":{"model_id":{"type":"string"},"display_name":{"type":"string"},"provider_id":{"type":"string"},"provider_name":{"type":"string"},"tier":{"type":"string"},"total_cost":{"type":"number"},"breakdown":{"type":"array","items":{"$ref":"#/components/schemas/CostBreakdown"}},"alternatives":{"type":"array","items":{"$ref":"#/components/schemas/CostAlternative"}},"resolved_from":{"type":"string"}}},"CostAlternative":{"type":"object","properties":{"provider_id":{"type":"string"},"provider_name":{"type":"string"},"total_cost":{"type":"number"},"savings_pct":{"type":"number"}}},"CostBreakdown":{"type":"object","properties":{"dimension":{"type":"string"},"quantity":{"type":"number"},"unit_price":{"type":"number"},"unit":{"type":"string"},"cost":{"type":"number"}}},"EnrichedRegion":{"type":"object","properties":{"name":{"type":"string"},"display_name":{"type":"string"},"geography":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"cloud":{"type":"string","enum":["aws","azure","gcp","global","other"]}}},"FilterOption":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer"}}},"LeaderboardEntry":{"type":"object","properties":{"rank":{"type":"integer"},"model_id":{"type":"string"},"display_name":{"type":"string"},"creator":{"type":"string"},"type":{"type":"string"},"value":{"type":"number"},"formatted_value":{"type":"string"}}},"ModelBenchmarks":{"type":"object","properties":{"model_id":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"slug":{"type":"string"},"scores":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"label":{"type":"string"},"value":{"type":"number"},"rank":{"type":"integer"},"total":{"type":"integer"},"percentile":{"type":"number"},"higher_is_better":{"type":"boolean"}}}}}}}}},"ModelIds":{"type":"object","properties":{"canonical":{"type":"string"},"litellm":{"type":"array","items":{"type":"string"}},"aa":{"type":"array","items":{"type":"string"}},"source":{"type":"array","items":{"type":"string"}}}},"ModelPriceHistory":{"type":"object","properties":{"model_id":{"type":"string"},"currency":{"type":"string"},"series":{"type":"array","items":{"type":"object","properties":{"provider_id":{"type":"string"},"dimension":{"type":"string"},"points":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"price":{"type":"number"},"unit":{"type":"string"}}}}}}}}},"ModelPricing":{"type":"object","properties":{"model_id":{"type":"string"},"currency":{"type":"string"},"exchange_rate":{"type":"number"},"exchange_rate_date":{"type":"string"},"ingestion_date":{"type":"string"},"summary":{"$ref":"#/components/schemas/PricingSummary"},"providers":{"type":"array","items":{"$ref":"#/components/schemas/ProviderPricing"}},"regions":{"type":"array","items":{"type":"string"}},"region_info":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/EnrichedRegion"}}}},"ModelsOptions":{"type":"object","description":"Faceted filter options for the models listing","properties":{"types":{"type":"array","items":{"$ref":"#/components/schemas/FilterOption"}},"creators":{"type":"array","items":{"$ref":"#/components/schemas/FilterOption"}},"families":{"type":"array","items":{"$ref":"#/components/schemas/FilterOption"}},"tiers":{"type":"array","items":{"$ref":"#/components/schemas/FilterOption"}},"capabilities":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"count":{"type":"integer"}}}},"providers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon_url":{"type":"string"},"model_count":{"type":"integer"}}}},"currencies":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"}}}},"price_dimensions":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"unit":{"type":"string"}}}},"total_models":{"type":"integer"},"total_priced_models":{"type":"integer"}}},"PaginationInfo":{"type":"object","properties":{"page_size":{"type":"integer"},"has_next":{"type":"boolean"},"next_token":{"type":"string","nullable":true},"total_count":{"type":"integer"}}},"PriceDimension":{"type":"object","properties":{"dimension":{"type":"string"},"price":{"type":"number"},"unit":{"type":"string"},"above_tokens":{"type":"integer"},"pricing_mode":{"type":"string"},"provider_model_id":{"type":"string"},"effective_date":{"type":"string","nullable":true},"source_id":{"type":"string"}}},"PricingRegion":{"type":"object","properties":{"region":{"type":"string"},"dimensions":{"type":"array","items":{"$ref":"#/components/schemas/PriceDimension"}}}},"PricingSummary":{"type":"object","properties":{"currency":{"type":"string"},"min_input_per_1m":{"type":"number","nullable":true},"max_input_per_1m":{"type":"number","nullable":true},"min_output_per_1m":{"type":"number","nullable":true},"max_output_per_1m":{"type":"number","nullable":true},"min_cache_read_per_1m":{"type":"number","nullable":true},"min_cache_creation_per_1m":{"type":"number","nullable":true},"min_reasoning_per_1m":{"type":"number","nullable":true},"cheapest_provider":{"type":"string","nullable":true},"provider_count":{"type":"integer"}}},"PricingTier":{"type":"object","properties":{"tier":{"type":"string"},"regions":{"type":"array","items":{"$ref":"#/components/schemas/PricingRegion"}}}},"ProviderPricing":{"type":"object","properties":{"provider_id":{"type":"string"},"provider_name":{"type":"string"},"tiers":{"type":"array","items":{"$ref":"#/components/schemas/PricingTier"}}}},"ResolvedId":{"type":"object","properties":{"id":{"type":"string"},"display_name":{"type":"string"},"match_type":{"type":"string"}}},"TypeaheadEntry":{"type":"object","properties":{"type":{"type":"string","enum":["model","provider"]},"id":{"type":"string"},"label":{"type":"string"},"sublabel":{"type":"string"},"url":{"type":"string"}}}}}}