Skip to content

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

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 AWS Bedrock model lifecycle metadata (startOfLifeTime). If the release date is not available from AWS 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"

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.