Skip to main content

Documentation Index

Fetch the complete documentation index at: https://braintrust.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Braintrust integrates with Amazon Bedrock so you can call Amazon’s foundation models from the Braintrust playground, API, and SDKs. Braintrust also traces AWS Bedrock SDK calls from your application.

Connect Bedrock to Braintrust

To use Bedrock models in the Braintrust playground, API, and proxy, connect Bedrock as a provider in your organization or project AI providers.
1

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.
2

Configure the integration

Open the Bedrock provider settings, choose how Braintrust should authenticate to AWS, and pick the region and model registry options:
  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, add it manually in the next step.
  8. Click Save.
3

Add models manually

You only need to do this step 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.
  • 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.
Use the AWS page that matches the kind of ID you need:
Use the model ID prefix to choose the format:
Bedrock model ID patternBraintrust format
anthropic.*Anthropic
amazon.*Converse
us.*, eu.*, apac.*, global.*Converse

Bedrock provider resources