Skip to main content

Bedrock

Use this when Loong should talk to AWS Bedrock through the Converse path and region ownership needs to stay explicit.

At A Glance

FieldValue
Built-in kindbedrock
Provider groupGateway And Compatibility Providers
Protocol familybedrock_converse
Feature familybedrock
Auth schemebearer
Credential envsAWS_BEARER_TOKEN_BEDROCK
Aliasesaws-bedrock, aws_bedrock
Default base URLhttps://bedrock-runtime.<region>.amazonaws.com
Request endpointhttps://bedrock-runtime.<region>.amazonaws.com/model/{modelId}/converse
Models endpointhttps://bedrock.<region>.amazonaws.com/foundation-models

Minimal Config

active_provider = "bedrock"

[providers.bedrock]
kind = "bedrock"
base_url = "https://bedrock-runtime.<region>.amazonaws.com"
model = "your-bedrock-model-id"

Verify It

loong doctor
loong list-models
loong ask --message "Say hello and name the active provider."
If list-models is unreliable for this account or region, pin an explicit provider.model or add preferred_models instead of leaving recovery implicit.

Auth And Routing Contract

ContractValue
Auth optionalno
Model probe auth optionalno
Default API key envAWS_BEARER_TOKEN_BEDROCK
OAuth envnone
Primary request routehttps://bedrock-runtime.<region>.amazonaws.com/model/{modelId}/converse
Primary model-catalog routehttps://bedrock.<region>.amazonaws.com/foundation-models

Operator Notes

  • set BEDROCK_AWS_REGION/AWS_REGION/AWS_DEFAULT_REGION or replace <region> in provider.base_url with your Bedrock runtime region.
  • Alternative auth path: configure AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY with BEDROCK_AWS_REGION, AWS_REGION, or AWS_DEFAULT_REGION for SigV4.
  • Bedrock expects a real model id such as an Anthropic or Amazon foundation-model identifier, not auto discovery as the final steady-state choice.