PHPackages                             clinically/prism-bedrock - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. clinically/prism-bedrock

ArchivedLibrary[Utility & Helpers](/categories/utility)

clinically/prism-bedrock
========================

A Prism provider for AWS Bedrock. Fork of prism-php/bedrock.

v0.1.1(3mo ago)78.0k↑5340%3[2 PRs](https://github.com/clinically-au/prism-bedrock/pulls)1MITPHPPHP ^8.2

Since Mar 23Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/clinically-au/prism-bedrock)[ Packagist](https://packagist.org/packages/clinically/prism-bedrock)[ GitHub Sponsors](https://github.com/sixlive)[ RSS](/packages/clinically-prism-bedrock/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (34)Versions (3)Used By (1)

Prism Bedrock — DEPRECATED
==========================

[](#prism-bedrock--deprecated)

> **This fork is no longer maintained.** This repository is archived.
>
> It was created to add streaming, image generation, and other fixes to [`prism-php/bedrock`](https://github.com/prism-php/bedrock) so that our [`clinically/laravel-ai-bedrock`](https://github.com/clinically-au/laravel-ai-bedrock) bridge could expose them through the Laravel AI SDK. Both packages are now obsolete because [`laravel/ai`](https://github.com/laravel/ai) ships native AWS Bedrock support (since v0.6.3, April 2026) — built directly on the AWS SDK, with streaming, tool calling, embeddings, and image generation included.
>
> - If you use `laravel/ai`, switch to its built-in `bedrock` provider.
> - If you use Prism directly, use upstream [`prism-php/bedrock`](https://github.com/prism-php/bedrock) instead. Any unmerged fixes here have been submitted upstream.

---

A [Prism](https://github.com/prism-php/prism) provider for AWS Bedrock in Laravel applications.

This was a maintained fork of [prism-php/bedrock](https://github.com/prism-php/bedrock) with additional features including streaming support, image generation, thinking/reasoning content, and cache token tracking.

Installation
------------

[](#installation)

```
composer require clinically/prism-bedrock
```

Configuration
-------------

[](#configuration)

Add the following to your Prism configuration (`config/prism.php`):

```
'bedrock' => [ // Key should match Bedrock::KEY
    'region' => env('AWS_REGION', 'us-east-1'),

    // Set to true to ignore other auth configuration and use the AWS SDK default credential chain
    // read more at https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials_default_chain.html
    'use_default_credential_provider' => env('AWS_USE_DEFAULT_CREDENTIAL_PROVIDER', false),

    'api_key' => env('AWS_ACCESS_KEY_ID'), //  Ignored with `use_default_credential_provider` === true
    'api_secret' => env('AWS_SECRET_ACCESS_KEY'), //  Ignored with `use_default_credential_provider` === true
    'session_token' => env('AWS_SESSION_TOKEN'), // Only required for temporary credentials. Ignored with `use_default_credential_provider` === true
],
```

Usage
-----

[](#usage)

### Text Generation

[](#text-generation)

```
use Prism\Prism\Prism;
use Clinically\PrismBedrock\Bedrock;

$response = Prism::text()
    ->using(Bedrock::KEY, 'anthropic.claude-3-sonnet-20240229-v1:0')
    ->withPrompt('Explain quantum computing in simple terms')
    ->asText();

echo $response->text;
```

### Structured Output (JSON)

[](#structured-output-json)

```
use Prism\Prism\Prism;
use Clinically\PrismBedrock\Bedrock;
use Prism\Prism\Schema\ObjectSchema;
use Prism\Prism\Schema\StringSchema;
use Prism\Prism\Schema\ArraySchema;

$schema = new ObjectSchema(
    name: 'languages',
    description: 'Top programming languages',
    properties: [
        new ArraySchema(
            'languages',
            'List of programming languages',
            items: new ObjectSchema(
                name: 'language',
                description: 'Programming language details',
                properties: [
                    new StringSchema('name', 'The language name'),
                    new StringSchema('popularity', 'Popularity description'),
                ]
            )
        )
    ]
);

$response = Prism::structured()
    ->using(Bedrock::KEY, 'anthropic.claude-3-sonnet-20240229-v1:0')
    ->withSchema($schema)
    ->withPrompt('List the top 3 programming languages')
    ->asStructured();

// Access your structured data
$data = $response->structured;
```

### Embeddings (with Cohere models)

[](#embeddings-with-cohere-models)

```
use Prism\Prism\Prism;
use Clinically\PrismBedrock\Bedrock;

$response = Prism::embeddings()
    ->using(Bedrock::KEY, 'cohere.embed-english-v3')
    ->fromArray(['The sky is blue', 'Water is wet'])
    ->asEmbeddings();

// Access the embeddings
$embeddings = $response->embeddings;
```

### Model names

[](#model-names)

Important

When using inference profiles via an ARN, you should urlencode the model name.

```
use Prism\Prism\Prism;
use Clinically\PrismBedrock\Bedrock;

$response = Prism::text()
    ->using(Bedrock::KEY, urlencode('arn:aws:bedrock:us-east-1:999999999999:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0'))
    ->withPrompt('Explain quantum computing in simple terms')
    ->asText();
```

Supported API Schemas
---------------------

[](#supported-api-schemas)

AWS Bedrock supports several API schemas - some LLM vendor specific, some generic.

Prism Bedrock supports three of those API schemas:

- **Converse**: AWS's native interface for chat (default)\*
- **Anthropic**: For Claude models\*\*
- **Cohere**: For Cohere embeddings models

Each schema supports different capabilities:

SchemaTextStreamingStructuredEmbeddingsConverse✅✅✅❌Anthropic✅✅✅❌Cohere❌❌❌✅\* A unified interface for multiple providers. See [AWS documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-supported-models-features.html) for a list of supported models.

\*\* The Converse schema does not support Anthropic's native features (e.g. PDF vision analysis). This schema uses Anthropic's native schema and therefore allows use of Anthropic native features. Please note however that Bedrock's Anthropic schema does not yet have feature parity with Anthropic. Notably it does not support documents or citations, and prompt caching support may be limited to specific Claude models. See the [AWS documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html) for the latest supported models. To use documents with Anthropic's models, use them via the Converse schema (though note that this not the same as using Anthropic's PDF vision directly).

Auto-resolution of API schemas
------------------------------

[](#auto-resolution-of-api-schemas)

Prism Bedrock resolves the most appropriate API schema from the model string. If it is unable to resolve a specific schema (e.g. anthropic for Anthropic), it will default to Converse.

Therefore if you use a model that is not supported by AWS Bedrock Converse, and does not have a specific Prism Bedrock implementation, your request will fail.

If you wish to force Prism Bedrock to use Converse instead of a vendor specific interface, you can do so with `withProviderOptions()`:

```
use Prism\Prism\Prism;
use Clinically\PrismBedrock\Bedrock;
use Clinically\PrismBedrock\Enums\BedrockSchema;

$response = Prism::text()
    ->using(Bedrock::KEY, 'anthropic.claude-3-sonnet-20240229-v1:0')
    ->withProviderOptions(['apiSchema' => BedrockSchema::Converse])
    ->withPrompt('Explain quantum computing in simple terms')
    ->asText();
```

Cache-Optimized Prompts
-----------------------

[](#cache-optimized-prompts)

For [supported models](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html), you can enable prompt caching to reduce latency and costs:

```
use Prism\Prism\Prism;
use Clinically\PrismBedrock\Bedrock;
use Prism\Prism\ValueObjects\Messages\UserMessage;

$response = Prism::text()
    ->using(Bedrock::KEY, 'anthropic.claude-3-sonnet-20240229-v1:0')
    ->withMessages([
        (new UserMessage('Message with cache breakpoint'))->withProviderOptions(['cacheType' => 'ephemeral']),
        (new UserMessage('Message with another cache breakpoint'))->withProviderOptions(['cacheType' => 'ephemeral']),
        new UserMessage('Compare the last two messages.')
    ])
    ->asText();
```

Tip

Anthropic currently supports a cacheType of "ephemeral". Converse currently supports a cacheType of "default". It is possible that Anthropic and/or AWS may add additional types in the future.

Structured Adapted Support
--------------------------

[](#structured-adapted-support)

Both Anthropic and Converse Schemas do not support a native structured format.

Prism Bedrock has adapted support by appending a prompt asking the model to a response conforming to the schema you provide.

The performance of that prompt may vary by model. You can override it using `withProviderOptions()`:

```
use Prism\Prism\Prism;
use Clinically\PrismBedrock\Bedrock;
use Prism\Prism\ValueObjects\Messages\UserMessage;

Prism::structured()
    ->withSchema($schema)
    ->using('bedrock', 'anthropic.claude-3-5-haiku-20241022-v1:0')
    ->withProviderOptions([
        // Override the default message of "Respond with ONLY JSON (i.e. not in backticks or a code block, with NO CONTENT outside the JSON) that matches the following schema:"
        'jsonModeMessage' => 'My custom message',
    ])
    ->withPrompt('My prompt')
    ->asStructured();
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

Credits
-------

[](#credits)

Originally created by [TJ Miller](https://tjmiller.me) and [Chris Bridges](https://github.com/chris-bridges) at [prism-php/bedrock](https://github.com/prism-php/bedrock). This fork is maintained by [Clinically](https://github.com/clinically-au).

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance89

Actively maintained with recent releases

Popularity34

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

2

Last Release

90d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2ea2e401c2f1f18cafc42d8fb98305ae3575db1fb25455af1c3156d0e79f90e?d=identicon)[wojt-janowski](/maintainers/wojt-janowski)

---

Top Contributors

[![wojt-janowski](https://avatars.githubusercontent.com/u/209190810?v=4)](https://github.com/wojt-janowski "wojt-janowski (15 commits)")[![ChrisB-TL](https://avatars.githubusercontent.com/u/101201552?v=4)](https://github.com/ChrisB-TL "ChrisB-TL (11 commits)")[![sixlive](https://avatars.githubusercontent.com/u/5108034?v=4)](https://github.com/sixlive "sixlive (3 commits)")[![ejunker](https://avatars.githubusercontent.com/u/4758?v=4)](https://github.com/ejunker "ejunker (3 commits)")[![mortenhauberg](https://avatars.githubusercontent.com/u/3660049?v=4)](https://github.com/mortenhauberg "mortenhauberg (1 commits)")[![FredrikPAC](https://avatars.githubusercontent.com/u/98091128?v=4)](https://github.com/FredrikPAC "FredrikPAC (1 commits)")[![rhysemmerson](https://avatars.githubusercontent.com/u/2549415?v=4)](https://github.com/rhysemmerson "rhysemmerson (1 commits)")[![pktharindu](https://avatars.githubusercontent.com/u/23132672?v=4)](https://github.com/pktharindu "pktharindu (1 commits)")[![james-astalty](https://avatars.githubusercontent.com/u/134993638?v=4)](https://github.com/james-astalty "james-astalty (1 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/clinically-prism-bedrock/health.svg)

```
[![Health](https://phpackages.com/badges/clinically-prism-bedrock/health.svg)](https://phpackages.com/packages/clinically-prism-bedrock)
```

###  Alternatives

[markwalet/nova-modal-response

A Laravel Nova asset for Modal responses on an action.

17818.7k](/packages/markwalet-nova-modal-response)[prism-php/relay

A Prism tool for interacting with MCP servers

15163.3k4](/packages/prism-php-relay)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)