Skip to main content

​
What it’s good for

Access to high-quality models (Claude, Nova, Llama) on AWS infrastructure. Native Converse API support, Titan and Nova embeddings for semantic recall. Good for users already in the AWS ecosystem or who want strong models without running local hardware.

​
Requirements

  • An AWS account with Amazon Bedrock access
  • A Bedrock API key (Bearer token)
  • Model access enabled in your AWS region
Generate your API key at: AWS Console > Amazon Bedrock > API keys

​
Configure in Spaceduck

​
Chat

1

Set your API key

In Settings > Chat, select Amazon Bedrock as the provider, then enter your API key.Or via CLI:
spaceduck config secret set /ai/secrets/bedrockApiKey
# Paste your key when prompted
2

Select a model

In Settings > Chat:
  • Provider: Amazon Bedrock
  • Model: choose from the dropdown, e.g.:
    • global.amazon.nova-2-lite-v1:0 (fast, cost-effective)
    • us.anthropic.claude-3-5-haiku-20241022-v1:0 (Claude Haiku)
    • amazon.nova-pro-v1:0 (Nova Pro)
Or via CLI:
spaceduck config set /ai/provider bedrock
spaceduck config set /ai/model "global.amazon.nova-2-lite-v1:0"
3

Verify

Send a message in the chat. If you get a streaming response, Bedrock is connected.
The model dropdown in Settings populates dynamically from Bedrock’s API once your key is set.

​
Embeddings

Bedrock supports Titan Text Embeddings V2 and Nova 2 Multimodal Embeddings.
1

Configure embedding model

In Settings > Memory:
  • Toggle Semantic recall on
  • Provider: Amazon Bedrock (or “Same as chat provider”)
  • Model: amazon.titan-embed-text-v2:0 or amazon.nova-2-multimodal-embeddings-v1:0
  • Dimensions: 1024 (Titan default) or as needed
Or via CLI:
spaceduck config set /embedding/enabled true
spaceduck config set /embedding/provider bedrock
spaceduck config set /embedding/model "amazon.titan-embed-text-v2:0"
spaceduck config set /embedding/dimensions 1024
2

Test

Click the Test button in Settings > Memory. You should see a green status indicator.
Bedrock uses the native Converse API for chat (required for Nova and Claude models) and the Invoke API for embeddings. The model type is auto-detected: models with “nova” in the ID use the Nova embedding API, others use Titan.

​
Test and troubleshoot

ProblemCauseFix
401 UnauthorizedInvalid or expired API keyRegenerate at AWS Console > Bedrock > API keys
403 ForbiddenModel not enabled in your regionEnable the model in Bedrock’s model access settings
Model dropdown shows few modelsAPI key wasn’t set when page loadedSave the key first, then re-open Settings
429 Too Many RequestsRate limit exceededWait and retry, or request a limit increase
Context length exceededMessage history too longSpaceduck auto-compacts, but very long conversations may need a new chat