Skip to content

AWS Bedrock Configuration Guide

Overview

This guide explains how to configure your Vell platform to route all AI requests through AWS Bedrock instead of direct API calls to Anthropic or Stability AI.

Available Bedrock Models

Claude Models (via Bedrock)

  • Global Inference Profiles (Recommended)
  • Claude Sonnet 4.5 (Global) - global.anthropic.claude-sonnet-4-5-20250929-v1:0
  • Claude Sonnet 4 (Global) - global.anthropic.claude-sonnet-4-20250514-v1:0

  • Claude Haiku 4.5 (Global) - global.anthropic.claude-haiku-4-5-20251001-v1:0

  • US Region Inference Profiles

  • Claude 3.5 Sonnet v2 (US) - us.anthropic.claude-3-5-sonnet-20241022-v2:0
  • Claude 3.5 Sonnet (US) - us.anthropic.claude-3-5-sonnet-20240620-v1:0
  • Claude 3.5 Haiku (US) - us.anthropic.claude-3-5-haiku-20241022-v1:0
  • Claude 3 Opus (US) - us.anthropic.claude-3-opus-20240229-v1:0

Amazon Nova Models (via Bedrock)

  • Amazon Nova Micro - amazon.nova-micro-v1:0 (Ultra low-cost)
  • Amazon Nova Lite - amazon.nova-lite-v1:0 (Low-cost)
  • Amazon Nova Pro - amazon.nova-pro-v1:0 (Mid-tier)
  • Amazon Nova Premier - amazon.nova-premier-v1:0 (Premium tier)

Stable Diffusion (via Bedrock)

  • SDXL 1.0 - stability.stable-diffusion-xl-v1

Configuration Steps

1. Configure AWS Credentials

Ensure your .env file has AWS credentials configured:

AWS_ACCESS_KEY_ID=your_access_key_here
AWS_SECRET_ACCESS_KEY=your_secret_key_here
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your_bucket_name

2. Enable Nova Models in Database

Run the migration to enable Bedrock models (if not already run):

php artisan migrate

This runs migration 2025_11_04_000002_add_bedrock_nova_and_claude_models_to_entities.php which adds all Bedrock Claude and Nova models to the entities table with status ENABLED.

3. Configure Default AI Engine for Text Generation

Option A: Use Bedrock Claude Models

  1. Go to Admin → Config → AI Tools Settings
  2. Set Default AI Engine to Anthropic
  3. Go to Admin → Settings → Anthropic
  4. In the "Default Anthropic Word Model" dropdown, select AWS Bedrock
  5. In the "Default AWS Bedrock Model" dropdown that appears, choose your model:
  6. Recommended: Claude Sonnet 4.5 (Global) for best performance
  7. Cost-effective: Claude Haiku 4.5 (Global) for lower cost
  8. Amazon Nova: Select any Nova model (Micro, Lite, Pro, or Premier)

Option B: Make Nova Models Available to Users

Nova models are already available! Users will see them in the AI model selector if: 1. The migration has run (adds them to entities table) 2. They have credits allocated for those models 3. The models are enabled (status = ENABLED)

4. Configure Image Generation via Bedrock

For AI Writer/Article Wizard:

  1. Go to Admin → Settings → Stable Diffusion
  2. In the Default StableDiffusion Image Model dropdown
  3. Select AWS Bedrock from the options
  4. In the Default AWS Bedrock Model section that appears
  5. Select SDXL 1.0 (stability.stable-diffusion-xl-v1)

Now all Stable Diffusion image generation in the Article Wizard will route through AWS Bedrock.

5. Configure Bedrock Access Model (BYOK Options)

Go to Admin → Config → AI Tools Settings, scroll to Step 7A: Bedrock Access Model

Choose one of three options:

  • Simple setup
  • Users consume your AWS credits
  • Uses platform AWS credentials from .env
  • Best for: Most SaaS deployments

User AWS Access Keys (BYOK)

  • Users provide their own AWS Access Key ID and Secret Key
  • Users pay AWS directly
  • Requires users to configure their keys in Account Settings
  • Best for: Users who want to use their own AWS accounts

User IAM Role (BYOC - Most Secure)

  • Users deploy CloudFormation template in their AWS account
  • Platform assumes IAM role with External ID
  • No long-lived credentials stored
  • Best for: Enterprise customers with security requirements

6. Set Up Model Credits

  1. Go to Admin → Finance → Plans
  2. Edit your plans
  3. Under Bedrock Nova and Bedrock Claude sections:
  4. Set credit limits per model
  5. Or check "Unlimited" for unlimited usage
  6. Save the plan

7. Verify Configuration

Check Bedrock Models Are Available:

SELECT key, title, status, engine
FROM entities
WHERE key LIKE '%bedrock%' OR key LIKE '%nova%';

You should see entries like: - bedrock-claude-3-5-sonnet-v2 (status: enabled) - bedrock-nova-micro (status: enabled) - bedrock-nova-lite (status: enabled) - bedrock-nova-pro (status: enabled) - bedrock-nova-premier (status: enabled)

Test the Integration:

  1. Log in as a user
  2. Go to AI Chat
  3. Click the AI Model selector
  4. You should see Nova models and Bedrock Claude models listed
  5. Select a Bedrock model and send a test message

Key Settings Summary

To Route Through AWS Bedrock:

Feature Setting Location Configuration
Text Generation (Claude) Admin → Settings → Anthropic Select "AWS Bedrock" in model dropdown, then choose specific Bedrock model
Text Generation (Nova) Admin → Settings → Anthropic Select "AWS Bedrock" in model dropdown, then choose Nova model
Image Generation Admin → Settings → Stable Diffusion Select "AWS Bedrock" as default model
Default Engine Admin → Config → AI Tools Set to "Anthropic"
Access Model Admin → Config → AI Tools → Step 7A Choose Platform/User Keys/User Role

Cost Optimization Tips

Nova Models Pricing (AWS Bedrock):

  • Nova Micro: $0.00000035 per token (ultra low-cost)
  • Nova Lite: $0.0000006 per token (low-cost)
  • Nova Pro: $0.000008 per token (mid-tier)
  • Nova Premier: $0.00002 per token (premium)

Recommendation:

  • Use Nova Lite or Nova Micro for simple tasks (content summaries, basic chat)
  • Use Nova Pro for complex reasoning tasks
  • Use Claude Haiku 4.5 for balanced performance/cost with Claude quality
  • Use Claude Sonnet 4.5 for highest quality outputs

Troubleshooting

"You have no credits left"

  • Go to Admin → Finance → Plans
  • Edit the user's plan
  • Add credits for the specific Bedrock model they're trying to use

"AWS Bedrock client is not initialized"

  • Check .env file has AWS credentials
  • Verify AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are set
  • Ensure the AWS credentials have Bedrock access permissions

Models Not Appearing for Users

  • Run: php artisan migrate to ensure migration ran
  • Check entities table: models should have status = 'enabled'
  • Ensure user's plan has credits for those models

Images Still Using Direct Stability AI API

  • Go to Admin → Settings → Stable Diffusion
  • Ensure "AWS Bedrock" is selected as the model
  • The dropdown needs to explicitly show "AWS Bedrock" selected

AWS IAM Permissions Required

Your AWS credentials need these permissions for Bedrock:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream"
      ],
      "Resource": [
        "arn:aws:bedrock:*::foundation-model/*"
      ]
    }
  ]
}

Support

For issues or questions, refer to: - AWS Bedrock documentation: https://docs.aws.amazon.com/bedrock/ - Platform documentation: https://docs.vell.io