Models API¶

Discover and list available AWS Bedrock chat models through an Anthropic-compatible interface.

Route Prefix

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.

Note: If ANTHROPIC_ROUTES_PREFIX is set to the same value as OPENAI_ROUTES_PREFIX, this Anthropic-compatible Models API route will be disabled to avoid conflicts with the OpenAI-compatible Models API.

Why Use the Models API?¶

Complete Catalog
Browse all available AWS Bedrock models across regions.
Always Up-to-Date
Dynamic model discovery automatically shows new models as they become available in AWS 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 AWS Bedrock foundation models.

Quick Start: Available Endpoints¶

Endpoint	Method	What It Does	Powered By
`/v1/models`	GET	List all available models	AWS Bedrock
`/v1/models/{model_id}`	GET	Get details for a specific model	AWS Bedrock

Anthropic-Compatible with AWS Bedrock Power¶

Features:

Multi-region aggregation: Combines models from all configured AWS Bedrock regions
Cursor-based pagination: Use limit, after_id, and before_id query 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 AWS Bedrock model identifiers (e.g., anthropic.claude-haiku-4-5-20251001-v1:0) instead of Anthropic model names
Extended catalog: Includes all AWS Bedrock models (Claude, Nova, Llama, etc.), not just Anthropic models

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"

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 AWS Bedrock foundation models for chat and completion tasks.