Models API (Anthropic Compatible)¶
Discover and list available Amazon Bedrock text models through an Anthropic-compatible interface.
Route Prefix & Base URL
By default, all Anthropic-compatible routes are prefixed with /anthropic. This means the Models API is available at /anthropic/v1/models instead of /v1/models. You can customize this prefix using the ANTHROPIC_ROUTES_PREFIX configuration variable documented in Operations Configuration.
The curl examples below use a $BASE variable that must include this prefix — set it to your scheme and host followed by ANTHROPIC_ROUTES_PREFIX:
export BASE="https://your-host/anthropic" # <scheme>://<host> + ANTHROPIC_ROUTES_PREFIX
Note: ANTHROPIC_ROUTES_PREFIX must always be a non-empty path and is validated at startup to differ from OPENAI_ROUTES_PREFIX (the server refuses to start otherwise). This Anthropic-compatible Models API is therefore always served on its own path, distinct from the OpenAI-compatible Models API.
Why Choose the Models API?¶
-
Text Model Catalog
Browse the available Bedrock text models across regions. See the Models page for a browsable table. -
Always Up-to-Date
Dynamic model discovery automatically shows new models as they become available in Bedrock. -
Multi-Region Aggregation
Combines models from all configured AWS regions in one list. See which models are available in each region. -
Foundation Models
Includes Claude, Nova, Llama, and other Bedrock foundation text models.
Available Endpoints¶
| Endpoint | Method | What It Does | Powered By | MCP Tool |
|---|---|---|---|---|
/v1/models | GET | List all available text models | Amazon Bedrock | anthropic_model_list |
/v1/models/{model_id} | GET | Get details for a specific model | Amazon Bedrock | anthropic_model_get |
Anthropic-Compatible with Amazon Bedrock Power¶
Features:
- Multi-region aggregation: Combines models from all configured Bedrock regions
- Cursor-based pagination: Use
limit,after_id, andbefore_idquery parameters - Text models only: Returns only models with text input and text output modalities (Claude, Nova, Llama, etc.)
What's Different from Anthropic?¶
- Model IDs: Uses Bedrock model identifiers (e.g.,
anthropic.claude-haiku-4-5-20251001-v1:0) instead of Anthropic model names - Extended catalog: Includes all Bedrock text models (Claude, Nova, Llama, etc.), not just Anthropic models
- Default page size:
limitdefaults to1000(the Anthropic API defaults to20)
Created Date (created_at)
The created_at field is an RFC 3339 datetime string representing the time at which the model was released. This value is sourced from the Bedrock model lifecycle metadata (startOfLifeTime). If the release date is not available from Bedrock, it defaults to the Unix epoch ("1970-01-01T00:00:00Z").
Try It Now¶
List all available models:
curl -X GET "$BASE/v1/models" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"
List models with pagination:
curl -X GET "$BASE/v1/models?limit=10" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"
The limit query parameter accepts values from 1 to 1000 and defaults to 1000.
Get details for a specific model:
curl -X GET "$BASE/v1/models/amazon.nova-micro-v1:0" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"
Browse Bedrock foundation models for chat and completion tasks.