Skip to main content
Braintrust integrates with Amazon Bedrock, so you can use Amazon’s foundation models through the Braintrust playground, API, and SDKs.

​
Confirm model access in AWS

Before configuring Braintrust, make sure you can access the Bedrock models you want to use in AWS.
  1. Confirm the model is available in your target AWS region. See Supported foundation models in Amazon Bedrock.
  2. Confirm your AWS account is allowed to invoke that model. See Manage access to Amazon Bedrock foundation models.
  3. If you plan to use Bedrock API keys, confirm your region supports them. See Supported Regions and SDKs for Amazon Bedrock API keys.

​
Configure the integration

  1. Go to Settings > Project AI providers
  2. Under Cloud providers, click Bedrock.
  3. Choose your authentication method:
    • IAM credentials: Use an AWS access key ID and secret access key.
    • API key: Use an Amazon Bedrock bearer token.
    API keys are stored as one-way cryptographic hashes, never in plaintext.
  4. Set Region to the AWS region where Braintrust should send Bedrock requests. Choose a region where your target model is available. If you use a region-specific model ID such as us.anthropic.claude-sonnet-4-5-20250929-v1:0, make sure the selected region is compatible with that model.
  5. Enter credentials:
    • IAM credentials: Fill in Access key, then enter the secret access key in the Secret field. Use Session token if you are using temporary AWS credentials such as STS.
    • API key: Paste your Amazon Bedrock API key into the Secret field.
  6. Optional: Set API base if you need a custom Bedrock endpoint.
  7. Many Bedrock models are available in Braintrust by default. To access these, leave Include the default registry of Bedrock models enabled. If the model you want is not supported by default, you can add the model manually.
  8. Click Save.

​
Add models manually

You only need to add a Bedrock model manually if the model you want does not appear in Braintrust’s supported models list. This is common for newly released models, preview access models, or models your account has special access to. When you add a model manually:
  1. Copy the exact Bedrock model ID from AWS.
  2. Add it under Models in the Bedrock provider settings.
  3. Choose the matching Braintrust format.
Common model IDs:
  • anthropic.claude-sonnet-4-5-20250929-v1:0 — base model ID (provider.model-version:variant)
  • us.anthropic.claude-sonnet-4-5-20250929-v1:0 — cross-region inference profile (region.provider.model-version:variant)
  • amazon.nova-pro-v1:0 — base model ID
  • us.amazon.nova-pro-v1:0 — cross-region inference profile
If AWS offers both a base model ID and a fully versioned variation, prefer the fully versioned model ID.

​
How to find model IDs

Use the AWS page that matches the kind of ID you need:

​
Format guide

Use the model ID prefix to choose the format:
Bedrock model ID patternBraintrust format
anthropic.*Anthropic
amazon.*Converse
us.*, eu.*, apac.*, global.*Converse

​
Next steps

​
Additional resources