AWS bedrock documentation change
Summary
Removed all documentation for the Chat Completions API and refocused content solely on the Responses API. Updated terminology from 'OpenAI APIs' to specifically reference the Responses API endpoint.
Security assessment
The changes involve removing deprecated API documentation without any mention of security vulnerabilities, patches, or weaknesses. No security-related content was added or modified. This appears to be a product update discontinuing the Chat Completions API feature.
Diff
diff --git a/bedrock/latest/userguide/bedrock-mantle.md b/bedrock/latest/userguide/bedrock-mantle.md index 70adb7565..865249737 100644 --- a//bedrock/latest/userguide/bedrock-mantle.md +++ b//bedrock/latest/userguide/bedrock-mantle.md @@ -7 +7 @@ -Supported Regions and EndpointsPrerequisitesModels APIResponses APIChat Completions API +Supported Regions and EndpointsPrerequisitesModels APIResponses API @@ -9 +9 @@ Supported Regions and EndpointsPrerequisitesModels APIResponses APIChat Completi -# Generate responses using OpenAI APIs +# Inference using Responses API @@ -11 +11 @@ Supported Regions and EndpointsPrerequisitesModels APIResponses APIChat Completi -Amazon Bedrock provides OpenAI compatible API endpoints for model inference, powered by Mantle, a distributed inference engine for large-scale machine learning model serving. These endpoints allow you to use familiar OpenAI SDKs and tools with Amazon Bedrock models, enabling you to migrate existing applications with minimal code changes—simply update your base URL and API key. +Amazon Bedrock provides the OpenAI Responses API via the `bedrock-mantle` endpoint, powered by Mantle, a distributed inference engine for large-scale machine learning model serving. This endpoint allows you to use familiar OpenAI SDKs and tools with Amazon Bedrock models, enabling you to migrate existing applications with minimal code changes—simply update your base URL and API key. @@ -40 +40 @@ Key benefits include: -Amazon Bedrock is available in the following AWS Regions: +The `bedrock-mantle` endpoint is available in the following AWS Regions: @@ -81 +81 @@ Before using OpenAI APIs, ensure you have the following: -The Models API allows you to discover available models in Amazon Bedrock powered by Mantle. Use this API to retrieve a list of models you can use with the Responses API and Chat Completions API. For complete API details, see the [OpenAI Models documentation](https://platform.openai.com/docs/api-reference/models). +The Models API allows you to discover available models in Amazon Bedrock powered by Mantle. Use this API to retrieve a list of models you can use with the Responses API. For complete API details, see the [OpenAI Models documentation](https://platform.openai.com/docs/api-reference/models). @@ -216,100 +215,0 @@ Make a POST request to `/v1/responses` with `stream` set to `true`: -## Chat Completions API - -The Chat Completions API generates conversational responses. For complete API details, see the [OpenAI Chat Completions documentation](https://platform.openai.com/docs/api-reference/chat/create). - -### Create a chat completion - -To create a chat completion, choose the tab for your preferred method, and then follow the steps: - -OpenAI SDK (Python) - - -Configure the OpenAI client using environment variables: - - - # Create a chat completion using the OpenAI SDK - # Requires OPENAI_API_KEY and OPENAI_BASE_URL environment variables - - from openai import OpenAI - - client = OpenAI() - - completion = client.chat.completions.create( - model="openai.gpt-oss-120b", - messages=[ - {"role": "system", "content": "You are a helpful assistant."}, - {"role": "user", "content": "Hello!"} - ] - ) - - print(completion.choices[0].message) - - -HTTP request - - -Make a POST request to `/v1/chat/completions`: - - - # Create a chat completion - # Requires OPENAI_API_KEY and OPENAI_BASE_URL environment variables - - curl -X POST $OPENAI_BASE_URL/chat/completions \ - -H "Content-Type: application/json" \ - -H "Authorization: Bearer $OPENAI_API_KEY" \ - -d '{ - "model": "openai.gpt-oss-120b", - "messages": [ - {"role": "system", "content": "You are a helpful assistant."}, - {"role": "user", "content": "Hello!"} - ] - }' - - -### Enable streaming - -To receive responses incrementally, choose the tab for your preferred method, and then follow the steps: - -OpenAI SDK (Python) - - - - # Stream chat completion responses incrementally using the OpenAI SDK - # Requires OPENAI_API_KEY and OPENAI_BASE_URL environment variables - - from openai import OpenAI - - client = OpenAI() - - stream = client.chat.completions.create( - model="openai.gpt-oss-120b", - messages=[{"role": "user", "content": "Tell me a story"}], - stream=True - ) - - for chunk in stream: - if chunk.choices[0].delta.content is not None: - print(chunk.choices[0].delta.content, end="") - - -HTTP request - - -Make a POST request to `/v1/chat/completions` with ` stream` set to `true`: - - - # Stream chat completion responses incrementally - # Requires OPENAI_API_KEY and OPENAI_BASE_URL environment variables - - curl -X POST $OPENAI_BASE_URL/chat/completions \ - -H "Content-Type: application/json" \ - -H "Authorization: Bearer $OPENAI_API_KEY" \ - -d '{ - "model": "openai.gpt-oss-120b", - "messages": [ - {"role": "user", "content": "Tell me a story"} - ], - "stream": true - }' - - @@ -322 +222 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Latency-optimized inference +Making inference requests @@ -324 +224 @@ Latency-optimized inference -Inference using Bedrock APIs +Inference using Chat Completions API