本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 快速指南
<a name="getting-started"></a>

在本節中，我們將示範如何在幾分鐘內開始使用 Amazon Bedrock。我們將使用 OpenAI 相容 APIs：[Responses API](bedrock-mantle.md) 和 [Chat Completions API](inference-chat-completions.md)，以及 [Invoke](inference-invoke.md) 和 [Converse API](conversation-inference.md)，向您展示如何執行推論請求。[建置](build.md) 如需完整的 APIs清單，請參閱 。

**步驟 1 - AWS 帳戶：**如果您已經有 AWS 帳戶，請略過此步驟並前往步驟 2。如果您是初次使用 AWS，請註冊 [AWS 帳戶](https://portal.aws.amazon.com/billing/signup)並遵循指示。

**步驟 2 - API 金鑰：**擁有 AWS 帳戶後，您可以建立長期 API 金鑰來驗證對 Amazon Bedrock 的請求。若要這樣做，請前往 [AWS 主控台中的 Amazon Bedrock 服務](https://console.aws.amazon.com/bedrock/home#/api-keys/long-term/create)並產生長期金鑰。如需詳細資訊，請參閱[建置](build.md)章節中的 [API 金鑰](api-keys.md)一節。

**步驟 3 - 取得 SDK：**若要使用此入門指南，您必須已安裝 Python。然後，根據您使用的 APIs相關軟體。

------
#### [ Responses/Chat Completions API ]

```
pip install boto3 openai
```

------
#### [ Invoke/Converse API ]

```
pip install boto3
```

------

**步驟 4 - 設定環境變數：**設定您的環境以使用 API 金鑰進行身分驗證。

------
#### [ Responses/Chat Completions API ]

```
OPENAI_API_KEY="<provide your Bedrock API key>"
OPENAI_BASE_URL="https://bedrock-mantle.<your-region>.api.aws/v1"
```

------
#### [ Invoke/Converse API ]

```
AWS_BEARER_TOKEN_BEDROCK="<provide your Bedrock API key>"
```

------

**步驟 5 - 執行您的第一個推論請求：**Amazon Bedrock 支援[超過 100 個基礎模型](models.md)。選擇模型，然後使用下列 Python 程式碼來執行您的第一個推論請求。將檔案儲存為 `bedrock-first-request.py`

------
#### [ Responses API ]

```
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="openai.gpt-oss-120b",
    input="Can you explain the features of Amazon Bedrock?"
    )
print(response)
```

------
#### [ Chat Completions API ]

```
from openai import OpenAI

client = OpenAI()

response = client.chat.completions.create(
    model="openai.gpt-oss-120b",
    messages=[{"role": "user", "content": "Can you explain the features of Amazon Bedrock?"}]
    )
print(response)
```

------
#### [ Invoke API ]

```
import json
import boto3

client = boto3.client('bedrock-runtime', region_name='us-east-1')
response = client.invoke_model(
    modelId='anthropic.claude-opus-4-6-v1',
    body=json.dumps({
            'anthropic_version': 'bedrock-2023-05-31',
            'messages': [{ 'role': 'user', 'content': 'Can you explain the features of Amazon Bedrock?'}],
            'max_tokens': 1024
    })
 )
 print(json.loads(response['body'].read()))
```

------
#### [ Converse API ]

```
import boto3

client = boto3.client('bedrock-runtime', region_name='us-east-1')
response = client.converse(
    modelId='anthropic.claude-opus-4-6-v1',
    messages=[
        {
            'role': 'user',
            'content': [{'text': 'Can you explain the features of Amazon Bedrock?'}]
        }
    ]
)
print(response)
```

------

使用 命令以 Python 執行程式碼：

```
python3 bedrock-first-request.py
```

您應該會看到推論請求的輸出。

若要進一步了解如何使用其他 APIs和端點，請參閱 [建置](build.md)。