本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Qwen3-Coder-30B-A3B-Instruct ## ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/models/qwen.png) Qwen — Qwen3-Coder-30B-A3B-Instruct ## 模型詳細資訊 Qwen3 Coder 30B A3B 是 Qwen 的精簡編碼mixture-of-experts模型，具有 30B 總計和 3B 作用中參數，可有效產生程式碼。如需模型開發和效能的詳細資訊，請參閱[模型/服務卡](https://qwen.ai/blog?id=qwen3-coder)。 + **模型啟動日期：**2025 年 7 月 31 日 + **模型 EOL 日期：**不適用 + **最終使用者授權合約和使用條款：**[檢視](https://aws.amazon.com/legal/bedrock/third-party-models/) + **模型生命週期：**作用中 + **內容視窗：**128K 權杖 + **最大輸出字符：**16K | **輸入模態** | **輸出模式** | **[支援的 APIs ](https://docs.aws.amazon.com/bedrock/latest/userguide/apis.html)** | **[支援的端點](https://docs.aws.amazon.com/bedrock/latest/userguide/endpoints.html)** | | --- | --- | --- | --- | | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 音訊 | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 內嵌 | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) Responses | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) bedrock-runtime | | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 影像 | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 影像 | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) Chat Completions | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) bedrock-mantle | | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 語音 | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 語音 | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) Invoke | | | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) 文字 | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) 文字 | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) Converse | | | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 影片 | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) 影片 | | | **注意** 我們建議您盡可能使用 `bedrock-mantle`端點。 ## 功能和功能 ***Bedrock 功能*** **使用`bedrock-mantle`端點支援的功能** | **支援的** | **不支援** | | --- | --- | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/model-card-qwen-qwen3-coder-30b-a3b-instruct.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/model-card-qwen-qwen3-coder-30b-a3b-instruct.html) | **使用`bedrock-runtime`端點支援的功能** | **支援的** | **不支援** | | --- | --- | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/model-card-qwen-qwen3-coder-30b-a3b-instruct.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/model-card-qwen-qwen3-coder-30b-a3b-instruct.html) | ## 定價 如需定價，請參閱 [Amazon Bedrock 定價](https://aws.amazon.com/bedrock/pricing/)頁面。 ## 程式設計存取 使用以下模型 IDs和端點 URLs，以程式設計方式存取此模型。如需可用 APIs和端點的詳細資訊，請參閱[支援的 APIs](https://docs.aws.amazon.com/bedrock/latest/userguide/apis.html)和[支援的端點](https://docs.aws.amazon.com/bedrock/latest/userguide/endpoints.html)。 | **端點** | **模型 ID** | **區域端點 URL** | **地理推論 ID** | **全域推論 ID** | | --- | --- | --- | --- | --- | | bedrock-runtime | qwen.qwen3-coder-30b-a3b-v1:0 | https://bedrock-runtime.\$1region\$1.amazonaws.com | 不支援 | 不支援 | | bedrock-mantle | qwen.qwen3-coder-30b-a3b-instruct | https://bedrock-mantle.\$1region\$1.api.aws/v1 | 不支援 | 不支援 | *例如，如果 region 是 us-east-1 （維吉尼亞北部），則 bedrock-runtime 端點 URL 將為 "https://bedrock-runtime.us-east-1.amazonaws.com"，bedrock-mantle 則為 "https://bedrock-mantle.us-east-1.api.aws/v1"。* ## 服務層 Amazon Bedrock 提供多種服務層，以符合您的工作負載需求。**Standard** pay-per-token存取，無需任何承諾。**優先順序**透過以時間為基礎的承諾提供更高的輸送量。**Flex** 為彈性、non-time-sensitive工作負載提供較低成本的存取。**預留** 提供專用輸送量，並提供可預測工作負載的期限承諾。如需詳細資訊，請參閱 [服務方案](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)。 | **標準** | **優先順序** | **Flex** | **預留** | | --- | --- | --- | --- | | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ## 區域可用性 ***區域可用性一目了然*** Bedrock 提供三種推論選項：**為嚴格合規，區域內**將請求保留在單一 區域內，地理 （美國、歐洲等） 內區域間的**地理跨區域**路由可提高輸送量，同時遵守資料駐留，而全球**跨區域**路由則可在無駐留限制的情況下，在全球任何地方提供最大輸送量。如需詳細資訊，請參閱 [區域可用性](models-region-compatibility.md)頁面。 | **區域** | **區域內** | **地理** | **全域** | | --- | --- | --- | --- | | us-east-1 （維吉尼亞北部） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | us-east-2 （俄亥俄） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | us-west-2 （奧勒岡） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | eu-central-1 （法蘭克福） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | eu-north-1 （斯德哥爾摩） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | eu-south-1 （米蘭） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | eu-west-1 （愛爾蘭） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | eu-west-2 （倫敦） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | ap-northeast-1 （東京） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | ap-south-1 （孟買） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | ap-southeast-2 （雪梨） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | ap-southeast-3 （雅加達） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | | sa-east-1 （聖保羅） | ![\[Yes\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/zh_tw/bedrock/latest/userguide/images/icons/icon-no.png) | ## 配額和限制 您的 AWS 帳戶具有預設配額來維持服務的效能，並確保適當使用 Amazon Bedrock。指派給帳戶的預設配額可能會根據區域因素、付款歷史記錄、詐騙使用量和/或配額[增加請求](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-increase.html)的核准而更新。如需詳細資訊，請參閱 [Amazon Bedrock 的配額](quotas.md) 文件並查看模型[的限制](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#limits_bedrock)。 ## 範例程式碼 **步驟 1 - AWS 帳戶：**如果您已經有 AWS 帳戶，請略過此步驟。如果您是初次使用 AWS，請註冊 [AWS 帳戶](https://portal.aws.amazon.com/billing/signup)。 **步驟 2 - API 金鑰：**前往 [Amazon Bedrock 主控台](https://console.aws.amazon.com/bedrock/home#/api-keys/long-term/create)並產生長期 API 金鑰。 **步驟 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="" OPENAI_BASE_URL="https://bedrock-mantle..api.aws/v1" ``` ------ #### [ Invoke/Converse API ] ``` AWS_BEARER_TOKEN_BEDROCK="" ``` ------ **步驟 5 - 執行您的第一個推論請求：**將檔案儲存為 `bedrock-first-request.py` ------ #### [ Responses API ] ``` from openai import OpenAI client = OpenAI() response = client.responses.create( model="qwen.qwen3-coder-30b-a3b-instruct", 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="qwen.qwen3-coder-30b-a3b-instruct", 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='qwen.qwen3-coder-30b-a3b-v1:0', body=json.dumps({ '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='qwen.qwen3-coder-30b-a3b-v1:0', messages=[ { 'role': 'user', 'content': [{'text': 'Can you explain the features of Amazon Bedrock?'}] } ] ) print(response) ``` ------