Get started with BedrockRouter

Architecture

BedrockRouter is a thin, OpenAI-compatible proxy that lives in your AWS account. Requests authenticate with a Bedrock API key, get translated into the Bedrock InvokeModel / Converse protocol, and stream straight back to your client.

Quickstart

Get a working request in under five minutes.

1. 1

   Create an account

   Sign up at BedrockRouter to track your deployments and integrations.

   Create account →
2. 2

   Deploy the CloudFormation stack

   Click Deploy, follow the AWS console wizard, and wait ~60 seconds for the stack to finish.

   Deploy stack →
3. 3

   Copy your endpoint and API key

   Open the stack's Outputs tab. Copy ProxyURL and ApiKey.

4. 4

   Make your first request

   Use any OpenAI-compatible client.

   bash

   curl https://YOUR_PROXY_URL/v1/chat/completions \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "anthropic.claude-sonnet-4-5-20250929-v1:0",
       "messages": [{"role": "user", "content": "Hello, Bedrock!"}]
     }'

SDK examples

BedrockRouter speaks both OpenAI and Anthropic protocols. Pick the SDK you already use.

OpenAI Python

from openai import OpenAI

client = OpenAI(
    base_url="https://YOUR_PROXY_URL/v1",
    api_key="YOUR_API_KEY",
)

response = client.chat.completions.create(
    model="anthropic.claude-sonnet-4-5-20250929-v1:0",
    messages=[{"role": "user", "content": "Explain Bedrock in one sentence."}],
)

print(response.choices[0].message.content)

Anthropic TypeScript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://YOUR_PROXY_URL",
  apiKey: "YOUR_API_KEY",
});

const message = await client.messages.create({
  model: "anthropic.claude-sonnet-4-5-20250929-v1:0",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Bedrock!" }],
});

console.log(message.content);

Vercel AI SDK

import { createOpenAI } from "@ai-sdk/openai";
import { generateText } from "ai";

const bedrock = createOpenAI({
  baseURL: "https://YOUR_PROXY_URL/v1",
  apiKey: process.env.BEDROCK_API_KEY,
});

const { text } = await generateText({
  model: bedrock("minimax.minimax-m2-v1:0"),
  prompt: "Write a haiku about distributed systems.",
});

Authentication

BedrockRouter uses standard bearer token authentication. Pass your AWS Bedrock API key in the Authorization header on every request.

Authorization: Bearer brk_live_xxxxxxxxxxxxxxxxxxxx

Keys are scoped to your AWS account's Bedrock IAM permissions. Rotate or revoke them at any time from the AWS console — no code changes required on the proxy.

Pricing & billing

BedrockRouter charges zero markup. You pay AWS Bedrock's standard on-demand rates directly via your AWS bill. The Lambda proxy is metered separately under AWS Lambda — typically a few cents per million requests.

FAQ