> For the complete documentation index, see [llms.txt](https://docs.fastrouter.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fastrouter.ai/api-reference/models.md).

# List Models

## List Available Models

> Returns all available AI models along with their pricing, architecture, context length, supported parameters, and (where applicable) per-parameter allowed values. No authentication required.\
> \
> This is the source of truth for what each model accepts — use \`supported\_parameters\` and \`supported\_params\_details\` to programmatically discover the exact fields and accepted values for any model (chat, video, image, embedding, audio, etc.).

```json
{"openapi":"3.1.0","info":{"title":"FastRouter API Reference","version":"1.0.0"},"tags":[{"name":"Models","description":"List and retrieve available AI models with pricing and capability information."}],"servers":[{"url":"https://api.fastrouter.ai","description":"Production API"}],"security":[],"paths":{"/api/v1/models":{"get":{"operationId":"listModels","tags":["Models"],"summary":"List Available Models","description":"Returns all available AI models along with their pricing, architecture, context length, supported parameters, and (where applicable) per-parameter allowed values. No authentication required.\n\nThis is the source of truth for what each model accepts — use `supported_parameters` and `supported_params_details` to programmatically discover the exact fields and accepted values for any model (chat, video, image, embedding, audio, etc.).","parameters":[],"responses":{"200":{"description":"List of all available models","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","description":"Array of model objects","items":{"type":"object","properties":{"id":{"type":"string","description":"Model ID in provider/model format"},"name":{"type":"string","description":"Human-readable model name"},"description":{"type":"string","description":"Long-form description of the model"},"created":{"type":"integer","description":"Unix timestamp when the model was added"},"context_length":{"type":"integer","description":"Maximum context window size in tokens"},"architecture":{"type":"object","description":"Model architecture details","properties":{"modality":{"type":"string","description":"Combined modality string"},"input_modalities":{"type":"array","items":{"type":"string"},"description":"List of supported input modalities"},"output_modalities":{"type":"array","items":{"type":"string"},"description":"List of output modalities produced by the model"},"tokenizer":{"type":"string","description":"Tokenizer used by the model"}}},"pricing":{"type":"object","description":"Pricing details. All values are USD strings (per token unless otherwise noted). An empty string means the field is not applicable for this model.","properties":{"prompt":{"type":"string","description":"Cost per prompt token (USD)"},"completion":{"type":"string","description":"Cost per completion token (USD)"},"request":{"type":"string","description":"Cost per request"},"image":{"type":"string","description":"Cost per image"},"web_search":{"type":"string"},"citation":{"type":"string"},"reasoning":{"type":"string"},"duration":{"type":"string"},"internal_reasoning":{"type":"string"},"input_cache_read":{"type":"string"},"input_cache_write":{"type":"string"},"prompt_more_than_128k_input":{"type":"string"},"completion_more_than_128k_input":{"type":"string"},"prompt_more_than_200k_input":{"type":"string"},"completion_more_than_200k_input":{"type":"string"},"prompt_more_than_272k_input":{"type":"string"},"completion_more_than_272k_input":{"type":"string"},"web_search_per_1000_requests_low":{"type":"string"},"web_search_per_1000_requests_medium":{"type":"string"},"web_search_per_1000_requests_high":{"type":"string"},"web_search_per_1000_requests":{"type":"string"},"audio_output_per_minute":{"type":"string"},"audio_input":{"type":"string"},"audio_output":{"type":"string"},"cached_audio_input":{"type":"string"},"batchPrice":{"type":"object","description":"Per-token pricing for batch processing (if offered)"},"flex_service_tier_pricing":{"type":"object","description":"Flex service-tier pricing overrides (if offered)"},"videoCost":{"type":"array","description":"Per-length/resolution video pricing entries for video models. Null for non-video models."},"videoCostWithAudio":{"type":"array","description":"Per-length/resolution video pricing entries with audio for video models. Null when not applicable."},"imageCost":{"type":"array","description":"Per-size image pricing entries for image models. Null for non-image models."},"priceToShow":{"type":"object","description":"Pre-computed display prices used by the dashboard / docs"}}},"top_provider":{"type":"object","description":"Provider-level information for the model","properties":{"context_length":{"type":"integer"},"max_completion_tokens":{"type":"integer"},"is_moderated":{"type":"boolean"}}},"supported_parameters":{"type":"array","items":{"type":"string"},"description":"Names of parameters accepted by this model on its primary endpoint."},"supported_params_details":{"type":"object","description":"Per-parameter input format details (dataType, enum, min, max). Useful for validating requests before calling the endpoint. Only present for models that publish parameter schemas (typical for video / image / specialised models).","additionalProperties":{"type":"object","properties":{"inputFormat":{"type":"object","properties":{"dataType":{"type":"string","description":"Underlying data type (string, number, bool, ...)"},"enum":{"type":"array","description":"Allowed values (when restricted)"},"min":{"type":"number","description":"Minimum allowed value (numeric params)"},"max":{"type":"number","description":"Maximum allowed value (numeric params)"}}}}}},"models_extra_params":{"type":"object","description":"Extra model metadata","properties":{"category":{"type":"array","items":{"type":"string"},"description":"Optional category tags (e.g. Coding, Legal, Health). Can be null when no categories are assigned."}}},"is_active":{"type":"boolean","description":"Whether this model is currently active / available"},"creator":{"type":"string","description":"Original creator of the model"}}}}}}}}},"429":{"$ref":"#/components/responses/RateLimitError"},"500":{"description":"Internal Server Error"}}}}},"components":{"responses":{"RateLimitError":{"description":"Rate Limited - You have exceeded your request limits (TPM/RPM). Slow down or increase your limits.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"type":{"type":"string"},"code":{"type":"string"},"status":{"type":"integer"}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fastrouter.ai/api-reference/models.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
