+
+---
+
+[Models.dev](https://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](https://opencode.ai).
+
+## API
+
+You can access this data through an API.
+
+```bash
+curl https://models.dev/api.json
+```
+
+Use the **Model ID** field to do a lookup on any model; it's the identifier used by [AI SDK](https://ai-sdk.dev/).
+
+Provider-agnostic model metadata is available separately:
+
+```bash
+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:
+
+```bash
+curl https://models.dev/catalog.json
+```
+
+### Logos
+
+Provider logos are available as SVG files:
+
+```bash
+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.
+
+### Adding Model Metadata
+
+Model-only facts live in `models/`, using the same path-style IDs as provider models. For example, `models/openai/gpt-5.toml` defines metadata for the underlying GPT-5 model, while `providers/openai/models/gpt-5.toml` defines OpenAI-specific serving details such as pricing.
+
+Use model metadata for provider-agnostic facts:
+
+- `name`, `family`, `release_date`, `last_updated`, `knowledge`
+- `attachment`, `reasoning`, `tool_call`, `structured_output`, `temperature`
+- `[limit]` defaults like context, input, and output token limits
+- `[modalities]` defaults
+- `open_weights`, `license`, `links`, `weights`, and `benchmarks`
+
+Example:
+
+```toml
+name = "GPT-5"
+family = "gpt"
+release_date = "2025-08-07"
+last_updated = "2025-08-07"
+attachment = true
+reasoning = true
+temperature = false
+tool_call = true
+structured_output = true
+open_weights = false
+
+[limit]
+context = 400_000
+input = 272_000
+output = 128_000
+
+[modalities]
+input = ["text", "image"]
+output = ["text"]
+
+[[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"
+```
+
+Provider TOMLs can inherit these facts with `base_model` and then keep only provider-specific fields or overrides:
+
+```toml
+base_model = "openai/gpt-5"
+
+[cost]
+input = 1.25
+output = 10.00
+cache_read = 0.125
+
+[limit]
+context = 200_000 # optional provider override
+output = 32_000
+```
+
+Provider fields win over model metadata during generation. Use this when the underlying model is the same but a provider serves it with different context limits, modalities, features, or pricing.
+
+### 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:
+
+ ```toml
+ 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:
+
+ ```toml
+ npm = "@ai-sdk/openai-compatible" # Use OpenAI-compatible SDK
+ api = "https://api.example.com/v1" # Required with openai-compatible
+ ```
+
+#### 2. Add a Logo (optional)
+
+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
+
+```
+
+#### 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 example, for the model ID `openai/gpt-5`, create a folder `openai/` and place a file named `gpt-5.toml` inside it.
+
+```toml
+name = "Model Display Name"
+attachment = true # or false - supports file attachments
+reasoning = false # or true - supports reasoning / chain-of-thought
+tool_call = true # or false - supports tool calling
+structured_output = true # or false - supports a dedicated structured output feature
+temperature = true # or false - supports temperature control
+knowledge = "2024-04" # Knowledge-cutoff date
+release_date = "2025-02-19" # First public release date
+last_updated = "2025-02-19" # Most recent update date
+open_weights = true # or false - model’s trained weights are publicly available
+
+[cost]
+input = 3.00 # Cost per million input tokens (USD)
+output = 15.00 # Cost per million output tokens (USD)
+reasoning = 15.00 # Cost per million reasoning tokens (USD)
+cache_read = 0.30 # Cost per million cached read tokens (USD)
+cache_write = 3.75 # Cost per million cached write tokens (USD)
+input_audio = 1.00 # Cost per million audio input tokens (USD)
+output_audio = 10.00 # Cost per million audio output tokens (USD)
+
+[limit]
+context = 400_000 # Maximum context window (tokens)
+input = 272_000 # Maximum input tokens
+output = 8_192 # Maximum output tokens
+
+[modalities]
+input = ["text", "image"] # Supported input modalities
+output = ["text"] # Supported output modalities
+
+[interleaved]
+field = "reasoning_content" # Name of the interleaved field "reasoning_content" or "reasoning_details"
+```
+
+#### 3a. Reuse Model Metadata with `base_model`
+
+For wrapper providers that mirror an existing model, prefer referencing the model-only metadata instead of duplicating provider-agnostic fields.
+
+Use `base_model` when the provider serves the same underlying model and only provider-specific fields differ.
+
+```toml
+base_model = "anthropic/claude-opus-4-6"
+
+[cost]
+input = 5.00
+output = 25.00
+```
+
+Rules:
+
+- `base_model` must point to a TOML file in `models/` using `/`.
+- You can override any top-level model field locally.
+- If you override a nested table like `[cost]`, `[limit]`, or `[modalities]`, include the full values needed for that table.
+- `base_model_omit` is optional and removes inherited model metadata fields after local overrides are merged. Use dot-path strings, for example `base_model_omit = ["limit.input"]`.
+- `id` still comes from the filename; do not add it to the TOML.
+
+Use `base_model` when the wrapper model is materially the same as the source model and only differs by provider-specific pricing, limits, modalities, provider request shape, or lifecycle flags.
+
+Sync and generator scripts should preserve existing `base_model` / `base_model_omit` fields when updating provider TOMLs. Do not use legacy `[extends]` tables.
+
+#### 4. Submit a Pull Request
+
+1. Fork this repo
+2. Create a new branch with your changes
+3. Add your provider and/or model files
+4. Open a PR with a clear description
+
+### Validation
+
+There's a GitHub Action that will automatically validate your submission against our schema to ensure:
+
+- All required fields are present
+- Data types are correct
+- Values are within acceptable ranges
+- TOML syntax is valid
+
+When moving existing provider fields into model metadata, compare generated output before and after the change:
+
+```bash
+bun run compare:migrations
+```
+
+This prints a diff for each changed model TOML so you can confirm the generated JSON only changed where you intended.
+
+### Schema Reference
+
+Models must conform to the following schema, as defined in `packages/core/src/schema.ts`.
+
+**Provider Schema:**
+
+- `name`: String - Display name of the provider
+- `npm`: String - AI SDK Package name
+- `env`: String[] - Environment variable keys used for auth
+- `doc`: String - Link to the provider's documentation
+- `api` _(optional)_: String - OpenAI-compatible API endpoint. Required only when using `@ai-sdk/openai-compatible` as the npm package
+
+**Model Schema:**
+
+- `name`: String — Display name of the model
+- `attachment`: Boolean — Supports file attachments
+- `reasoning`: Boolean — Supports reasoning / chain-of-thought
+- `tool_call`: Boolean - Supports tool calling
+- `structured_output` _(optional)_: Boolean — Supports structured output feature
+- `temperature` _(optional)_: Boolean — Supports temperature control
+- `knowledge` _(optional)_: String — Knowledge-cutoff date in `YYYY-MM` or `YYYY-MM-DD` format
+- `release_date`: String — First public release date in `YYYY-MM` or `YYYY-MM-DD`
+- `last_updated`: String — Most recent update date in `YYYY-MM` or `YYYY-MM-DD`
+- `open_weights`: Boolean - Indicate the model's trained weights are publicly available
+- `interleaved` _(optional)_: Boolean or Object — Supports interleaved reasoning. Use `true` for general support or an object with `field` to specify the format
+- `interleaved.field`: String — Name of the interleaved field (`"reasoning_content"` or `"reasoning_details"`)
+- `cost.input`: Number — Cost per million input tokens (USD)
+- `cost.output`: Number — Cost per million output tokens (USD)
+- `cost.reasoning` _(optional)_: Number — Cost per million reasoning tokens (USD)
+- `cost.cache_read` _(optional)_: Number — Cost per million cached read tokens (USD)
+- `cost.cache_write` _(optional)_: Number — Cost per million cached write tokens (USD)
+- `cost.input_audio` _(optional)_: Number — Cost per million audio input tokens, if billed separately (USD)
+- `cost.output_audio` _(optional)_: Number — Cost per million audio output tokens, if billed separately (USD)
+- `limit.context`: Number — Maximum context window (tokens)
+- `limit.input`: Number — Maximum input tokens
+- `limit.output`: Number — Maximum output tokens
+- `modalities.input`: Array of strings — Supported input modalities (e.g., ["text", "image", "audio", "video", "pdf"])
+- `modalities.output`: Array of strings — Supported output modalities (e.g., ["text"])
+- `status` _(optional)_: String — Supported status:
+ - `alpha` - Indicate the model is in alpha testing
+ - `beta` - Indicate the model is in beta testing
+ - `deprecated` - Indicate the model is no longer served by the provider's public API
+
+### Examples
+
+See existing providers in the `providers/` directory for reference:
+
+- `providers/anthropic/` - Anthropic Claude models
+- `providers/openai/` - OpenAI GPT models
+- `providers/google/` - Google Gemini models
+
+### Working on frontend
+
+Make sure you have [Bun](https://bun.sh/) installed.
+
+```bash
+$ bun install
+$ cd packages/web
+$ bun run dev
+```
+
+And it'll open the frontend at http://localhost:3000
+
+### Manual testing with opencode
+
+You can manually check provider changes with opencode by:
+
+```bash
+$ bun install
+$ cd packages/web
+$ bun run build
+$ OPENCODE_MODELS_PATH="dist/_api.json" opencode
+```
+
+### Questions?
+
+Open an issue if you need help or have questions about contributing.
+
+---
+
+Models.dev is created by the maintainers of [SST](https://sst.dev).
+
+**Join our community** [Discord](https://sst.dev/discord) | [YouTube](https://www.youtube.com/c/sst-dev) | [X.com](https://x.com/SST_dev)
+