APIs supported by Amazon Bedrock - Amazon Bedrock
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

APIs supported by Amazon Bedrock

Inference APIs supported

Amazon Bedrock provide four main API patterns to perform inference in Amazon Bedrock.

API method Service endpoint Use-case best suited for Key feature
Responses API (recommended) bedrock-mantle.<suffix> Stateful conversations Use the Responses API for modern, agentic applications requiring built-in tool use (search, code interpreter), multimodal inputs, and stateful conversations
Chat completions bedrock-mantle.<suffix> (recommended) and bedrock-runtime.<suffix> Stateless multi-turn chat Use the Chat Completions API for lightweight, stateless, text-focused tasks where you need full control over chat history management and lower latency.
Converse method bedrock-runtime.<suffix> Multi-turn chat/standardizing The Converse API provides a unified interface for interacting with all models in Amazon Bedrock.
Invoke method bedrock-runtime.<suffix> Single transactions / Large payloads The Invoke API provides direct access to models with more ability to control the request and response format.

Note: suffix is {region}.amazonaws.com

Read more about the APIs supported by Amazon Bedrock.

Deciding between APIs

The API you use depends on your use-case.

Use Case Recommended API
Migrating from OpenAI API-compatible endpoint Use OpenAI-compatible APIs: Responses API or Chat Completions API. According to OpenAI, the recommended API long-term is Responses API.
Using models not compatible with OpenAI-compatible endpoint Use native Amazon Bedrock APIs: Converse and Invoke. For more information, see Submit prompts and generate responses using the API.
Consistent interface across all models Converse API - Works with all models that support messages. Write code once and use it with different models. For example code, see Converse API examples.
Direct model access with full control Invoke API - Provides direct access to models with more control over request and response format. Use for generating text, images, and embeddings. For example code, see Invoke model code examples.
New to Amazon Bedrock Start with the Responses API

Models supported by each API and endpoint

First, browse our models to decide on the model you want to use. Once you decide on the model you want to use, you can see the APIs it supports and based on that you choose which endpoint to use. The bedrock-mantle supports the Responses and Chat Completions API. The bedrock-runtime supports the Invoke and Converse API.