Models API¶

Discover and list available AWS Bedrock models across all configured regions through an OpenAI-compatible interface.

Why Use the Models API?¶

Complete Catalog
Browse all available models across AWS Bedrock regions. Chat, embeddings, images, and specialized AI services.
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.
Comprehensive Coverage
Includes Bedrock foundation models plus AWS AI services (Polly, Transcribe, Translate) in one unified API.

Quick Start: Available Endpoints¶

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

OpenAI-Compatible with AWS Bedrock Power¶

Features:

Multi-region aggregation: Combines models from all configured AWS Bedrock regions
Comprehensive catalog: Includes Bedrock foundation models plus specialized models (Transcribe, Polly, etc.)

What's Different from OpenAI?¶

Detailed ownership: owned_by field shows provider and region (e.g., Amazon (AWS Bedrock us-east-1))
Model-specific capabilities: Modalities and context windows vary by model—consult AWS documentation for specifics

Created Date (created)

The created field is a Unix timestamp (integer) 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 0 (Unix epoch, January 1, 1970).

Try It Now¶

List all available models:

curl -X GET "$BASE/v1/models" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Get details for a specific model:

curl -X GET "$BASE/v1/models/amazon.nova-micro-v1:0" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Browse foundation models for chat, embeddings, images, audio, and more.