Models.dev

---

Models.dev is a comprehensive open-source database of AI model specifications, pricing, and capabilities.

There's no single database with information about all the available AI models. We started Models.dev as a community-contributed project to address this. We also use it internally in opencode.

API

You can access this data through an API.

curl https://models.dev/api.json

Specialized model types are omitted by default. Filter by one or more comma-separated model types, or use all for the complete catalog:

curl "https://models.dev/api.json?type=decision"
curl "https://models.dev/api.json?type=all"

The currently supported model type is decision. The type parameter is also available on models.json, catalog.json, and model-schema.json.

Use the Model ID field to do a lookup on any model; it's the identifier used by AI SDK.

Provider-agnostic model metadata is available separately:

curl https://models.dev/models.json

Use this for facts about the model itself, independent of where it is served. If you need both provider endpoints and model-only metadata in one response:

curl https://models.dev/catalog.json

Logos

Provider logos are available as SVG files:

curl https://models.dev/logos/{provider}.svg

Replace {provider} with the Provider ID (e.g., anthropic, openai, google). If we don't have a provider's logo, a default logo is served instead.

Contributing

The data is stored in the repo as TOML files; organized by provider and model. The logo is stored as an SVG. This is used to generate this page and power the API.

We need your help keeping the data up to date.

File Format

Every model file uses the v2 format and starts with schema = 2; bun validate rejects files without it. The full file schema is in packages/core/src/schema-v2.ts, and AGENTS.md has the complete contributor rules. The filename (minus .toml) is the model ID; never add an id field.

Adding Model Metadata

Model-only facts live in models/<lab>/<model>.toml. For example, models/openai/gpt-5.toml describes the underlying GPT-5 model, while providers/openai/models/gpt-5.toml describes how OpenAI serves it (reasoning controls, cache, pricing).

Lab files hold only what is true on every host:

schema = 2
name = "GPT-5"
description = "Original GPT-5 workhorse for reasoning, coding, writing, and tool workflows"
family = "gpt"
open_weights = false
knowledge = "2024-09-30"
release_date = "2025-08-07"

[modalities]
input = ["text", "image/jpeg", "image/png", "image/gif", "image/webp"]
output = ["text"]

[capabilities]
tools = { supported = true }
reasoning = { supported = true }
temperature = false
top_p = false
top_k = false

[limit]
context = 400_000
input = 272_000
output = 128_000

[[benchmarks]]
name = "Benchmark Name"
score = 72.5
metric = "accuracy"
source = "https://example.com/results"

[[weights]]
label = "Model weights"
url = "https://huggingface.co/example/model"
format = "safetensors"

Use MIME types for modalities where the lab documents them. last_updated is only needed when it differs from release_date. Reasoning controls, structured_output, cache, and service tiers are per host and go in provider files.

Adding a New Provider Model

To add a new model, start by checking if the provider already exists in the providers/ directory. If not, then:

1. Create a Provider

If the provider isn't already in providers/:

1. Create a new folder in providers/ with the provider's ID. For example, providers/newprovider/.

2. Add a provider.toml with the provider details:

   name = "Provider Name"
   npm = "@ai-sdk/provider" # AI SDK Package name
   env = ["PROVIDER_API_KEY"] # Environment Variable keys used for auth
   doc = "https://example.com/docs/models" # Link to provider's documentation
   

   If the provider doesn’t publish an npm package but exposes an OpenAI-compatible endpoint, set the npm field accordingly and include the base URL:

   npm = "@ai-sdk/openai-compatible" # Use OpenAI-compatible SDK
   api = "https://api.example.com/v1" # Required with openai-compatible
   

2. Add a Logo (required for new providers)

To add a logo for the provider:

1. Add a logo.svg file to the provider's directory (e.g., providers/newprovider/logo.svg)
2. Use SVG format with no fixed size or colors - use currentColor for fills/strokes

Example SVG structure:

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor">
  <!-- Logo paths here -->
</svg>

3. Add a Model Definition

Create a new TOML file in the provider's models/ directory where the filename is the model ID. If the model ID contains /, use subfolders: for openai/gpt-5, create openai/gpt-5.toml.

If the provider didn't create the model, point base_model at the lab file (add the lab file first if it's missing) and write only what differs on this host:

schema = 2
base_model = "openai/gpt-5"

[capabilities]
reasoning = { supported = true, effort = ["minimal", "low", "medium", "high"] }
structured_output = true
cache = { implicit = { min_tokens = 1_024 } }

[cost.text.input]
price = 1.25              # USD per million input tokens
cache = { read = 0.125 }  # USD per million cached input tokens

[[cost.text.input.overrides]]
when = { context = { gt = 272_000 } } # long-context pricing
price = 2.5

[cost.text.output]
price = 10                # USD per million output tokens

[limit]
context = 200_000         # optional: only when this host serves a smaller window

Rules:

This is the beginning of the README. Read the rest at the original. Read the full README ↗