Qwen-MT API參考 - Alibaba Cloud Model Studio

相關文檔：翻譯能力（Qwen-MT）

OpenAI 相容

新加坡地區
美國（維吉尼亞）地區
北京地區

SDK 調用配置的base_url為：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1HTTP 要求地址：POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions

阿里雲百鍊為華北2（北京）、新加坡、中國香港地區推出了業務空間專屬網域名稱，能夠為推理請求提供卓越的效能和更高的穩定性，建議遷移至新網域名稱：

華北2（北京）地區：從 https://dashscope.aliyuncs.com 遷移至 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
新加坡地區：從 https://dashscope-intl.aliyuncs.com 遷移至 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
中國香港地區：從 https://cn-hongkong.dashscope.aliyuncs.com 遷移至 https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com

其中 {WorkspaceId} 為您的業務空間 ID，可在阿里雲百鍊控制台的業務空間詳情頁面查看。現有網域名稱仍可正常使用。

您需要已擷取與配置 API Key 並配置API Key到環境變數。若通過OpenAI SDK進行調用，需要安裝SDK 。

請求體	基礎使用術語幹預翻譯記憶領域提示 Python Node.js curl import os from openai import OpenAI client = OpenAI( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv("DASHSCOPE_API_KEY"), # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", ) messages = [ { "role": "user", "content": "我看到這個視頻後沒有笑" } ] translation_options = { "source_lang": "auto", "target_lang": "English" } completion = client.chat.completions.create( model="qwen-mt-plus", messages=messages, extra_body={ "translation_options": translation_options } ) print(completion.choices[0].message.content) // 需要 Node.js v18+，需在 ES Module 環境下運行 import OpenAI from "openai"; const openai = new OpenAI( { // 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：apiKey: "sk-xxx", apiKey: process.env.DASHSCOPE_API_KEY, // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1" } ); const completion = await openai.chat.completions.create({ model: "qwen-mt-plus", messages: [ { role: "user", content: "我看到這個視頻後沒有笑" } ], translation_options: { source_lang: "Chinese", target_lang: "English" } }); console.log(JSON.stringify(completion)); 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 `curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-mt-plus", "messages": [{"role": "user", "content": "看完這個視頻我沒有笑"}], "translation_options": { "source_lang": "auto", "target_lang": "English" } }'` Python Node.js curl import os from openai import OpenAI client = OpenAI( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv("DASHSCOPE_API_KEY"), # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", ) messages = [ { "role": "user", "content": "而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "terms": [ { "source": "生物特徵辨識感應器", "target": "biological sensor" }, { "source": "石墨烯", "target": "graphene" }, { "source": "化學元素", "target": "chemical elements" }, { "source": "身體健康情況", "target": "health status of the body" } ] } completion = client.chat.completions.create( model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, extra_body={ "translation_options": translation_options } ) print(completion.choices[0].message.content) // 需要 Node.js v18+，需在 ES Module 環境下運行 import OpenAI from "openai"; const openai = new OpenAI( { // 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：apiKey: "sk-xxx", apiKey: process.env.DASHSCOPE_API_KEY, // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1" } ); const completion = await openai.chat.completions.create({ model: "qwen-mt-plus", messages: [ { role: "user", content: "而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。" } ], translation_options: { source_lang: "Chinese", target_lang: "English", terms: [ { "source": "生物特徵辨識感應器", "target": "biological sensor" }, { "source": "石墨烯", "target": "graphene" }, { "source": "化學元素", "target": "chemical elements" }, { "source": "身體健康情況", "target": "health status of the body" } ] } }); console.log(JSON.stringify(completion)); 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-mt-plus", "messages": [ { "role": "user", "content": "而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。" } ], "translation_options": { "source_lang": "Chinese", "target_lang": "English", "terms": [ { "source": "生物特徵辨識感應器", "target": "biological sensor" }, { "source": "石墨烯", "target": "graphene" }, { "source": "化學元素", "target": "chemical elements" }, { "source": "身體健康情況", "target": "health status of the body" } ] } }' Python Node.js curl import os from openai import OpenAI client = OpenAI( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv("DASHSCOPE_API_KEY"), # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", ) messages = [ { "role": "user", "content": "通過如下命令可以看出安裝thrift的版本資訊；" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "tm_list": [ { "source": "您可以通過如下方式查看叢集的核心版本資訊:", "target": "You can use one of the following methods to query the engine version of a cluster:" }, { "source": "我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website." }, { "source": "您可以通過PyPI來安裝SDK,安裝命令如下:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:" } ] } completion = client.chat.completions.create( model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, extra_body={ "translation_options": translation_options } ) print(completion.choices[0].message.content) // 需要 Node.js v18+，需在 ES Module 環境下運行 import OpenAI from "openai"; const openai = new OpenAI( { // 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：apiKey: "sk-xxx", apiKey: process.env.DASHSCOPE_API_KEY, // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1" } ); const completion = await openai.chat.completions.create({ model: "qwen-mt-plus", messages: [ { role: "user", content: "通過如下命令可以看出安裝thrift的版本資訊；" } ], translation_options: { source_lang: "Chinese", target_lang: "English", tm_list: [ { "source": "您可以通過如下方式查看叢集的核心版本資訊:", "target": "You can use one of the following methods to query the engine version of a cluster:" }, { "source": "我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website." }, { "source": "您可以通過PyPI來安裝SDK,安裝命令如下:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:" } ] } }); console.log(JSON.stringify(completion)); 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-mt-plus", "messages": [ { "role": "user", "content": "通過如下命令可以看出安裝thrift的版本資訊；" } ], "translation_options": { "source_lang": "Chinese", "target_lang": "English", "tm_list":[ {"source": "您可以通過如下方式查看叢集的核心版本資訊:", "target": "You can use one of the following methods to query the engine version of a cluster:"}, {"source": "我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website."}, {"source": "您可以通過PyPI來安裝SDK,安裝命令如下:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:"} ] } }' Python Node.js curl import os from openai import OpenAI client = OpenAI( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv("DASHSCOPE_API_KEY"), # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1", ) messages = [ { "role": "user", "content": "第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style." } completion = client.chat.completions.create( model="qwen-mt-plus", messages=messages, extra_body={ "translation_options": translation_options } ) print(completion.choices[0].message.content) // 需要 Node.js v18+，需在 ES Module 環境下運行 import OpenAI from "openai"; const openai = new OpenAI( { // 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：apiKey: "sk-xxx", apiKey: process.env.DASHSCOPE_API_KEY, // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1" } ); const completion = await openai.chat.completions.create({ model: "qwen-mt-plus", messages: [ { role: "user", content: "第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。" } ], translation_options: { source_lang: "Chinese", target_lang: "English", domains: "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style." } }); console.log(JSON.stringify(completion)); 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \ -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-mt-plus", "messages": [ { "role": "user", "content": "第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。" } ], "translation_options": { "source_lang": "Chinese", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style." } }'
model`string`（必選）模型名稱。支援的模型：qwen-mt-plus、qwen-mt-flash、qwen-mt-lite、qwen-mt-turbo。
messages`array`（必選）訊息數組，用於向大模型傳遞上下文。僅支援傳入 User Message。訊息類型 User Message`object`（必選）使用者訊息，用於傳遞待翻譯的句子。屬性 content`string`（必選）待翻譯的句子。role`string`（必選）使用者訊息的角色，必須設為`user`。
stream`boolean`（可選）預設值為 `false`是否以流式方式輸出回複。可選值： `false`：等待模型產生完整回複後一次性返回。 `true`：模型邊產生邊返回資料區塊。用戶端需逐塊讀取，以還原完整回複。當前僅qwen-mt-flash、qwen-mt-lite模型支援以增量形式返回資料，每次返回僅包含新產生的內容。qwen-mt-plus和qwen-mt-turbo模型以非增量形式返回資料，每次返回當前已經產生的整個序列，暫時無法修改。如：II didnI didn'tI didn't laughI didn't laugh after...
stream_options`object`（可選）流式輸出的配置項，僅在 `stream` 為 `true` 時生效。屬性 include_usage`boolean`（可選）預設值為 `false`是否在最後一個資料區塊包含Token消耗資訊。可選值： `true`：包含； `false`：不包含。
max_tokens`integer`（可選）用於限制模型輸出的最大 Token 數。若產生內容超過此值，響應將被截斷。預設值與最大值均為模型的最大輸出長度，請參見模型選型。
seed`integer`（可選）隨機數種子。用於確保在相同輸入和參數下產生結果可複現。若調用時傳入相同的 `seed` 且其他參數不變，模型將儘可能返回相同結果。取值範圍：`[0,2 31 −1]`。
temperature`float`（可選）預設值為0.65採樣溫度，控制模型產生文本的多樣性。temperature越高，產生的文本更多樣，反之，產生的文本更確定。取值範圍： [0, 2)temperature與top_p均可以控制產生文本的多樣性，建議只設定其中一個值。
top_p`float`（可選）預設值為0.8核採樣的機率閾值，控制模型產生文本的多樣性。top_p越高，產生的文本更多樣。反之，產生的文本更確定。取值範圍：（0,1.0]temperature與top_p均可以控制產生文本的多樣性，建議只設定其中一個值。
top_k`integer`（可選）預設值為1產生過程中採樣候選集的大小。例如，取值為50時，僅將單次產生中得分最高的50個Token組成隨機採樣的候選集。取值越大，產生的隨機性越高；取值越小，產生的確定性越高。取值為None或當top_k大於100時，表示不啟用top_k策略，此時僅有top_p策略生效。取值需要大於或等於0。該參數非OpenAI標準參數。通過 Python SDK調用時，請放入 extra_body 對象中，配置方式為：`extra_body={"top_k": xxx}`；通過 Node.js SDK或HTTP方式調用時，請作為頂層參數傳遞。
repetition_penalty`float`（可選）預設值為1.0模型產生時連續序列中的重複度。提高repetition_penalty時可以降低模型產生的重複度，1.0表示不做懲罰。沒有嚴格的取值範圍，只要大於0即可。該參數非OpenAI標準參數。通過 Python SDK調用時，請放入 extra_body 對象中，配置方式為：`extra_body={"repetition_penalty": xxx}`；通過 Node.js SDK或HTTP方式調用時，請作為頂層參數傳遞。
translation_options`object`（必選）需配置的翻譯參數。屬性 source_lang `string` （必選）源語言的英文全稱，詳情請參見支援的語言。若設為`auto`，模型會自動識別輸入的語種。target_lang `string` （必選）目標語言的英文全稱，詳情請參見支援的語言。terms `arrays` （可選）使用術語幹預功能時需設定的術語數組。屬性 source `string` （必選）源語言的術語。target `string` （必選）目標語言的術語。 tm_list `arrays` （可選）使用翻譯記憶功能時需設定的翻譯記憶數組。屬性 source `string` （必選）源語言的語句。target `string` （必選）目標語言的語句。 domains `string` （可選）使用領域提示功能時需設定的領域提示句。領域提示句暫時只支援英文。該參數非OpenAI標準參數。通過 Python SDK調用時，請放入 extra_body 對象中，配置方式為：`extra_body={"translation_options": xxx}`；通過 Node.js SDK或HTTP方式調用時，請作為頂層參數傳遞。

chat響應對象（非流式輸出）	{ "id": "chatcmpl-999a5d8a-f646-4039-968a-167743ae0f22", "choices": [ { "finish_reason": "stop", "index": 0, "logprobs": null, "message": { "content": "I didn't laugh after watching this video.", "refusal": null, "role": "assistant", "annotations": null, "audio": null, "function_call": null, "tool_calls": null } } ], "created": 1762346157, "model": "qwen-mt-plus", "object": "chat.completion", "service_tier": null, "system_fingerprint": null, "usage": { "completion_tokens": 9, "prompt_tokens": 53, "total_tokens": 62, "completion_tokens_details": null, "prompt_tokens_details": null } }
id`string`本次請求的唯一識別碼。
choices`array`模型產生內容的數組。屬性 finish_reason`string`模型停止產生的原因。有兩種情況：自然停止輸出時為`stop`；產生長度過長而結束為`length`。 index`integer`當前對象在`choices`數組中的索引。message`object`模型輸出的訊息。屬性 content `string`模型翻譯結果。refusal `string`該參數當前固定為`null`。role `string`訊息的角色，固定為`assistant`。audio `object`該參數當前固定為`null`。function_call `object`該參數當前固定為`null`。tool_calls `array`該參數當前固定為`null`。
created`integer`本次請求被建立時的時間戳記。
model`string`本次請求使用的模型。
object `string`始終為`chat.completion`。
service_tier `string`該參數當前固定為`null`。
system_fingerprint`string`該參數當前固定為`null`。
usage `object`本次請求的 Token 消耗資訊。屬性 completion_tokens `integer`模型輸出的 Token 數。prompt_tokens `integer`輸入的 Token 數。total_tokens `integer`消耗的總 Token 數，為`prompt_tokens`與`completion_tokens`的總和。completion_tokens_details `object`該參數當前固定為`null`。prompt_tokens_details `object`該參數當前固定為`null`。

chat響應chunk對象（流式輸出）	{"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "", "function_call": null, "refusal": null, "role": "assistant", "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "I", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " didn", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "'t", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " laugh", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " after", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " watching", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " this", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": " video", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": ".", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": null, "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": "stop", "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [{"delta": {"content": "", "function_call": null, "refusal": null, "role": null, "tool_calls": null}, "finish_reason": "stop", "index": 0, "logprobs": null}], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": null} {"id": "chatcmpl-d8aa6596-b366-4ed0-9f6d-2e89247f554e", "choices": [], "created": 1762504029, "model": "qwen-mt-flash", "object": "chat.completion.chunk", "service_tier": null, "system_fingerprint": null, "usage": {"completion_tokens": 9, "prompt_tokens": 56, "total_tokens": 65, "completion_tokens_details": null, "prompt_tokens_details": null}}
id`string`本次調用的唯一識別碼。每個chunk對象有相同的 id。
choices`array`模型產生內容的數組。若設定`include_usage`參數為`true`，則在最後一個chunk中為空白。屬性 delta `object`流式返回的輸出內容。屬性 content `string`翻譯結果，qwen-mt-flash和qwen-mt-lite為增量式更新，qwen-mt-plus和qwen-mt-turbo為非增量式更新。function_call `object`該參數當前固定為`null`。refusal `object`該參數當前固定為`null`。role `string`訊息對象的角色，只在第一個chunk中有值。 finish_reason `string`模型停止產生的原因。有三種情況：自然停止輸出時為`stop`；產生未結束時為`null`；產生長度過長而結束為`length`。 index `integer`當前響應在`choices`數組中的索引。
created`integer`本次請求被建立時的時間戳記。每個chunk有相同的時間戳記。
model`string`本次請求使用的模型。
object `string`始終為`chat.completion.chunk`。
service_tier `string`該參數當前固定為`null`。
system_fingerprint`string`該參數當前固定為`null`。
usage `object`本次請求消耗的Token。只在`include_usage`為`true`時，在最後一個chunk返回。屬性 completion_tokens `integer`模型輸出的 Token 數。prompt_tokens `integer`輸入 Token 數。total_tokens `integer`總 Token 數，為`prompt_tokens`與`completion_tokens`的總和。completion_tokens_details `object`該參數當前固定為`null`。prompt_tokens_details `object`該參數當前固定為`null`。

DashScope

新加坡地區
美國（維吉尼亞）地區
北京地區

HTTP 要求地址：POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generationSDK調用配置的base_url：

Python代碼
Java代碼

dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

方式一：

import com.alibaba.dashscope.protocol.Protocol;
Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1");

方式二：

import com.alibaba.dashscope.utils.Constants;
Constants.baseHttpApiUrl="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";

HTTP 要求地址：POST https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generationSDK調用配置的base_url：

Python代碼
Java代碼

dashscope.base_http_api_url = 'https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1'

方式一：

import com.alibaba.dashscope.protocol.Protocol;
Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1");

方式二：

import com.alibaba.dashscope.utils.Constants;
Constants.baseHttpApiUrl="https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1";

您需要已擷取與配置 API Key 並配置API Key到環境變數。若通過DashScope SDK進行調用，需要安裝DashScope SDK 。

請求體	基礎使用術語幹預翻譯記憶領域提示 Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "我看到這個視頻後沒有笑" } ] translation_options = { "source_lang": "auto", "target_lang": "English", } response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("我看到這個視頻後沒有笑") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .build(); GenerationParam param = GenerationParam.builder() // 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：.apiKey("sk-xxx") .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); e.printStackTrace(); } finally { System.exit(0); } } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 `curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "我看到這個視頻後沒有笑", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "auto", "target_lang": "English" } } }'` Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "terms": [ { "source": "生物特徵辨識感應器", "target": "biological sensor" }, { "source": "石墨烯", "target": "graphene" }, { "source": "化學元素", "target": "chemical elements" }, { "source": "身體健康情況", "target": "health status of the body" } ] } response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import java.util.Arrays; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.aigc.generation.TranslationOptions.Term; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。") .build(); Term term1 = Term.builder() .source("生物特徵辨識感應器") .target("biological sensor") .build(); Term term2 = Term.builder() .source("身體健康情況") .target("health status of the body") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .terms(Arrays.asList(term1, term2)) .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); } System.exit(0); } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "Chinese", "target_lang": "English", "terms": [ { "source": "生物特徵辨識感應器", "target": "biological sensor" }, { "source": "身體健康情況", "target": "health status of the body" } ] } }' Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "通過如下命令可以看出安裝thrift的版本資訊；" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "tm_list": [ { "source": "您可以通過如下方式查看叢集的核心版本資訊:", "target": "You can use one of the following methods to query the engine version of a cluster:" }, { "source": "我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website." }, { "source": "您可以通過PyPI來安裝SDK,安裝命令如下:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:" } ]} response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import java.util.Arrays; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.aigc.generation.TranslationOptions.Tm; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("通過如下命令可以看出安裝thrift的版本資訊；") .build(); Tm tm1 = Tm.builder() .source("您可以通過如下方式查看叢集的核心版本資訊:") .target("You can use one of the following methods to query the engine version of a cluster:") .build(); Tm tm2 = Tm.builder() .source("我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;") .target("The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website.") .build(); Tm tm3 = Tm.builder() .source("您可以通過PyPI來安裝SDK,安裝命令如下:") .target("You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .tmList(Arrays.asList(tm1, tm2, tm3)) .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); } System.exit(0); } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "通過如下命令可以看出安裝thrift的版本資訊；", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "Chinese", "target_lang": "English", "tm_list":[ {"source": "您可以通過如下方式查看叢集的核心版本資訊:", "target": "You can use one of the following methods to query the engine version of a cluster:"}, {"source": "我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website."}, {"source": "您可以通過PyPI來安裝SDK,安裝命令如下:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:"} ] } }' Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style." } response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .domains("The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style.") .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); } System.exit(0); } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "Chinese", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."} } }'
model`string`（必選）模型名稱。支援的模型：qwen-mt-plus、qwen-mt-flash、qwen-mt-lite、qwen-mt-turbo。
messages`array`（必選）訊息數組，用於向大模型傳遞上下文。僅支援傳入 User Message。訊息類型 User Message`object`（必選）使用者訊息，用於傳遞待翻譯的句子。屬性 content`string`（必選）待翻譯的句子。role`string`（必選）使用者訊息的角色，必須設為`user`。
max_tokens`integer`（可選）用於限制模型輸出的最大 Token 數。若產生內容超過此值，響應將被截斷。預設值與最大值均為模型的最大輸出長度，請參見模型選型。 Java SDK中為maxTokens。通過HTTP調用時，請將 max_tokens放入 parameters 對象中。
seed`integer`（可選）隨機數種子。用於確保在相同輸入和參數下產生結果可複現。若調用時傳入相同的 `seed` 且其他參數不變，模型將儘可能返回相同結果。取值範圍：`[0,2 31 −1]`。通過HTTP調用時，請將 seed放入 parameters 對象中。
temperature`float`（可選）預設值為0.65採樣溫度，控制模型產生文本的多樣性。temperature越高，產生的文本更多樣，反之，產生的文本更確定。取值範圍： [0, 2)temperature與top_p均可以控制產生文本的多樣性，建議只設定其中一個值。通過HTTP調用時，請將 temperature放入 parameters 對象中。
top_p`float`（可選）預設值為0.8核採樣的機率閾值，控制模型產生文本的多樣性。top_p越高，產生的文本更多樣。反之，產生的文本更確定。取值範圍：（0,1.0]temperature與top_p均可以控制產生文本的多樣性，建議只設定其中一個值。 Java SDK中為topP。通過HTTP調用時，請將 top_p放入 parameters 對象中。
repetition_penalty`float`（可選）預設值為1.0模型產生時連續序列中的重複度。提高repetition_penalty時可以降低模型產生的重複度，1.0表示不做懲罰。沒有嚴格的取值範圍，只要大於0即可。 Java SDK中為repetitionPenalty。通過HTTP調用時，請將 repetition_penalty放入 parameters 對象中。
top_k`integer`（可選）預設值為1產生過程中採樣候選集的大小。例如，取值為50時，僅將單次產生中得分最高的50個Token組成隨機採樣的候選集。取值越大，產生的隨機性越高；取值越小，產生的確定性越高。取值為None或當top_k大於100時，表示不啟用top_k策略，此時僅有top_p策略生效。取值需要大於或等於0。 Java SDK中為topK。通過HTTP調用時，請將 top_k放入 parameters 對象中。
stream`boolean`（可選）是否以流式方式輸出回複。可選值： `false`：等待模型產生完整回複後一次性返回。 `true`：模型邊產生邊返回資料區塊。用戶端需逐塊讀取，以還原完整回複。當前僅qwen-mt-flash、qwen-mt-lite模型支援以增量形式返回資料，每次返回僅包含新產生的內容。qwen-mt-plus和qwen-mt-turbo模型以非增量形式返回資料，每次返回當前已經產生的整個序列，暫時無法修改。如：II didnI didn'tI didn't laughI didn't laugh after... 該參數僅支援Python SDK。通過Java SDK實現流式輸出請通過`streamCall`介面調用；通過HTTP實現流式輸出請在Header中指定`X-DashScope-SSE`為`enable`。
translation_options`object`（必選）需配置的翻譯參數。屬性 source_lang `string` （必選）源語言的英文全稱，詳情請參見支援的語言。若設為`auto`，模型會自動識別輸入的語種。target_lang `string` （必選）目標語言的英文全稱，詳情請參見支援的語言。terms `arrays` （可選）使用術語幹預功能時需設定的術語數組。屬性 source `string` （必選）源語言的術語。target `string` （必選）目標語言的術語。 tm_list `arrays` （可選）使用翻譯記憶功能時需設定的翻譯記憶數組。屬性 source `string` （必選）源語言的語句。target `string` （必選）目標語言的語句。 domains `string` （可選）使用領域提示功能時需設定的領域提示句。領域提示句暫時只支援英文。 Java SDK中為`translationOptions`。通過HTTP調用時，請將 translation_options放入 parameters 對象中。

chat響應對象（流式與非流式輸出格式一致）	`{ "status_code": 200, "request_id": "9b4ec3b2-6d29-40a6-a08b-7e3c9a51c289", "code": "", "message": "", "output": { "text": null, "finish_reason": "stop", "choices": [ { "finish_reason": "stop", "message": { "role": "assistant", "content": "I didn't laugh after watching this video." } } ], "model_name": "qwen-mt-plus" }, "usage": { "input_tokens": 53, "output_tokens": 9, "total_tokens": 62 } }`
status_code`string`本次請求的狀態代碼。200 表示請求成功，否則表示請求失敗。 Java SDK 通過`GenerationResult.getStatusCode()`返回該參數（成功時為 200）。調用失敗會拋出異常，可通過`ApiException.getStatus().getStatusCode()`擷取錯誤狀態代碼。
request_id`string`本次調用的唯一識別碼。 Java SDK返回參數為requestId。
code`string`錯誤碼，調用成功時為空白值。只有Python SDK返回該參數。
output`object`調用結果資訊。屬性 text`string`該參數當前固定為`null`。finish_reason`string`模型結束產生的原因。有以下情況：正在產生時為`null`；模型輸出自然結束為`stop`；因產生長度過長而結束為`length`； choices`array`模型的輸出資訊。屬性 finish_reason`string`有以下情況：正在產生時為`null`；因模型輸出自然結束為`stop`；因產生長度過長而結束為`length`； message`object`模型輸出的訊息對象。屬性 role`string`輸出訊息的角色，固定為`assistant`。content`string`翻譯的結果。 model_name`string`本次請求使用的模型名稱。
usage`object`本次請求使用的Token資訊。屬性 input_tokens `integer`輸入 Token 數。output_tokens `integer`輸出 Token 數。total_tokens `integer`總 Token 數，為input_tokens與output_tokens之和。

錯誤碼

如果模型調用失敗並返回報錯資訊，請參見錯誤碼進行解決。 .aliyun-docs-content .one-codeblocks pre { max-height: calc(80vh - 136px) !important; height: auto; } .tab-item { font-size: 12px !important; /你可以根據需要調整字型大小/ padding: 0px 5px !important; } .expandable-content { border-left: none !important; border-right: none !important; border-bottom: none !important; }

請求體	基礎使用術語幹預翻譯記憶領域提示 Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "我看到這個視頻後沒有笑" } ] translation_options = { "source_lang": "auto", "target_lang": "English", } response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("我看到這個視頻後沒有笑") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .build(); GenerationParam param = GenerationParam.builder() // 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：.apiKey("sk-xxx") .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); e.printStackTrace(); } finally { System.exit(0); } } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 `curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "我看到這個視頻後沒有笑", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "auto", "target_lang": "English" } } }'` Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "terms": [ { "source": "生物特徵辨識感應器", "target": "biological sensor" }, { "source": "石墨烯", "target": "graphene" }, { "source": "化學元素", "target": "chemical elements" }, { "source": "身體健康情況", "target": "health status of the body" } ] } response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import java.util.Arrays; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.aigc.generation.TranslationOptions.Term; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。") .build(); Term term1 = Term.builder() .source("生物特徵辨識感應器") .target("biological sensor") .build(); Term term2 = Term.builder() .source("身體健康情況") .target("health status of the body") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .terms(Arrays.asList(term1, term2)) .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); } System.exit(0); } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "而這套生物特徵辨識感應器運用了石墨烯這種新型材料，它的目標物是化學元素，敏銳的“嗅覺”讓它能更深度、準確地體現身體健康情況。", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "Chinese", "target_lang": "English", "terms": [ { "source": "生物特徵辨識感應器", "target": "biological sensor" }, { "source": "身體健康情況", "target": "health status of the body" } ] } }' Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "通過如下命令可以看出安裝thrift的版本資訊；" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "tm_list": [ { "source": "您可以通過如下方式查看叢集的核心版本資訊:", "target": "You can use one of the following methods to query the engine version of a cluster:" }, { "source": "我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website." }, { "source": "您可以通過PyPI來安裝SDK,安裝命令如下:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:" } ]} response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", # 此處以qwen-mt-plus為例，可按需更換模型名稱 messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import java.util.Arrays; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.aigc.generation.TranslationOptions.Tm; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("通過如下命令可以看出安裝thrift的版本資訊；") .build(); Tm tm1 = Tm.builder() .source("您可以通過如下方式查看叢集的核心版本資訊:") .target("You can use one of the following methods to query the engine version of a cluster:") .build(); Tm tm2 = Tm.builder() .source("我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;") .target("The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website.") .build(); Tm tm3 = Tm.builder() .source("您可以通過PyPI來安裝SDK,安裝命令如下:") .target("You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .tmList(Arrays.asList(tm1, tm2, tm3)) .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); } System.exit(0); } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "通過如下命令可以看出安裝thrift的版本資訊；", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "Chinese", "target_lang": "English", "tm_list":[ {"source": "您可以通過如下方式查看叢集的核心版本資訊:", "target": "You can use one of the following methods to query the engine version of a cluster:"}, {"source": "我們雲HBase的thrift環境是0.9.0,所以建議用戶端的版本也為 0.9.0,可以從這裡下載thrift的0.9.0 版本,下載的源碼包我們後面會用到,這裡需要先安裝thrift編譯環境,對於源碼安裝可以參考thrift官網;", "target": "The version of Thrift used by ApsaraDB for HBase is 0.9.0. Therefore, we recommend that you use Thrift 0.9.0 to create a client. Click here to download Thrift 0.9.0. The downloaded source code package will be used later. You must install the Thrift compiling environment first. For more information, see Thrift official website."}, {"source": "您可以通過PyPI來安裝SDK,安裝命令如下:", "target": "You can run the following command in Python Package Index (PyPI) to install Elastic Container Instance SDK for Python:"} ] } }' Python Java curl import os import dashscope # 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1' messages = [ { "role": "user", "content": "第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。" } ] translation_options = { "source_lang": "Chinese", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style." } response = dashscope.Generation.call( # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為：api_key="sk-xxx", api_key=os.getenv('DASHSCOPE_API_KEY'), model="qwen-mt-plus", messages=messages, result_format='message', translation_options=translation_options ) print(response.output.choices[0].message.content) // DashScope SDK 版本需要不低於 2.20.6 import java.lang.System; import java.util.Collections; import com.alibaba.dashscope.aigc.generation.Generation; import com.alibaba.dashscope.aigc.generation.GenerationParam; import com.alibaba.dashscope.aigc.generation.GenerationResult; import com.alibaba.dashscope.aigc.generation.TranslationOptions; import com.alibaba.dashscope.common.Message; import com.alibaba.dashscope.common.Role; import com.alibaba.dashscope.exception.ApiException; import com.alibaba.dashscope.exception.InputRequiredException; import com.alibaba.dashscope.exception.NoApiKeyException; import com.alibaba.dashscope.protocol.Protocol; import com.alibaba.dashscope.utils.Constants; public class Main { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException { // 以下為新加坡地區配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1"); Message userMsg = Message.builder() .role(Role.USER.getValue()) .content("第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。") .build(); TranslationOptions options = TranslationOptions.builder() .sourceLang("auto") .targetLang("English") .domains("The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style.") .build(); GenerationParam param = GenerationParam.builder() .apiKey(System.getenv("DASHSCOPE_API_KEY")) .model("qwen-mt-plus") .messages(Collections.singletonList(userMsg)) .resultFormat(GenerationParam.ResultFormat.MESSAGE) .translationOptions(options) .build(); return gen.call(param); } public static void main(String[] args) { // 以下為華北2（北京）地區的配置，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的配置不同。 Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1"; try { GenerationResult result = callWithMessage(); System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent()); } catch (ApiException \| NoApiKeyException \| InputRequiredException e) { System.err.println("錯誤資訊："+e.getMessage()); } System.exit(0); } } 各地區的請求地址和API Key不同，以下是新加坡地區的請求地址。 curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation \ -H "Authorization: $DASHSCOPE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "model": "qwen-mt-plus", "input": { "messages": [ { "content": "第二個SELECT語句返回一個數字，表示在沒有LIMIT子句的情況下，第一個SELECT語句返回了多少行。", "role": "user" } ] }, "parameters": { "translation_options": { "source_lang": "Chinese", "target_lang": "English", "domains": "The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."} } }'
model`string`（必選）模型名稱。支援的模型：qwen-mt-plus、qwen-mt-flash、qwen-mt-lite、qwen-mt-turbo。
messages`array`（必選）訊息數組，用於向大模型傳遞上下文。僅支援傳入 User Message。訊息類型 User Message`object`（必選）使用者訊息，用於傳遞待翻譯的句子。屬性 content`string`（必選）待翻譯的句子。role`string`（必選）使用者訊息的角色，必須設為`user`。
max_tokens`integer`（可選）用於限制模型輸出的最大 Token 數。若產生內容超過此值，響應將被截斷。預設值與最大值均為模型的最大輸出長度，請參見模型選型。 Java SDK中為maxTokens。通過HTTP調用時，請將 max_tokens放入 parameters 對象中。
seed`integer`（可選）隨機數種子。用於確保在相同輸入和參數下產生結果可複現。若調用時傳入相同的 `seed` 且其他參數不變，模型將儘可能返回相同結果。取值範圍：`[0,2 31 −1]`。通過HTTP調用時，請將 seed放入 parameters 對象中。
temperature`float`（可選）預設值為0.65採樣溫度，控制模型產生文本的多樣性。temperature越高，產生的文本更多樣，反之，產生的文本更確定。取值範圍： [0, 2)temperature與top_p均可以控制產生文本的多樣性，建議只設定其中一個值。通過HTTP調用時，請將 temperature放入 parameters 對象中。
top_p`float`（可選）預設值為0.8核採樣的機率閾值，控制模型產生文本的多樣性。top_p越高，產生的文本更多樣。反之，產生的文本更確定。取值範圍：（0,1.0]temperature與top_p均可以控制產生文本的多樣性，建議只設定其中一個值。 Java SDK中為topP。通過HTTP調用時，請將 top_p放入 parameters 對象中。
repetition_penalty`float`（可選）預設值為1.0模型產生時連續序列中的重複度。提高repetition_penalty時可以降低模型產生的重複度，1.0表示不做懲罰。沒有嚴格的取值範圍，只要大於0即可。 Java SDK中為repetitionPenalty。通過HTTP調用時，請將 repetition_penalty放入 parameters 對象中。
top_k`integer`（可選）預設值為1產生過程中採樣候選集的大小。例如，取值為50時，僅將單次產生中得分最高的50個Token組成隨機採樣的候選集。取值越大，產生的隨機性越高；取值越小，產生的確定性越高。取值為None或當top_k大於100時，表示不啟用top_k策略，此時僅有top_p策略生效。取值需要大於或等於0。 Java SDK中為topK。通過HTTP調用時，請將 top_k放入 parameters 對象中。
stream`boolean`（可選）是否以流式方式輸出回複。可選值： `false`：等待模型產生完整回複後一次性返回。 `true`：模型邊產生邊返回資料區塊。用戶端需逐塊讀取，以還原完整回複。當前僅qwen-mt-flash、qwen-mt-lite模型支援以增量形式返回資料，每次返回僅包含新產生的內容。qwen-mt-plus和qwen-mt-turbo模型以非增量形式返回資料，每次返回當前已經產生的整個序列，暫時無法修改。如：II didnI didn'tI didn't laughI didn't laugh after... 該參數僅支援Python SDK。通過Java SDK實現流式輸出請通過`streamCall`介面調用；通過HTTP實現流式輸出請在Header中指定`X-DashScope-SSE`為`enable`。
translation_options`object`（必選）需配置的翻譯參數。屬性 source_lang `string` （必選）源語言的英文全稱，詳情請參見支援的語言。若設為`auto`，模型會自動識別輸入的語種。target_lang `string` （必選）目標語言的英文全稱，詳情請參見支援的語言。terms `arrays` （可選）使用術語幹預功能時需設定的術語數組。屬性 source `string` （必選）源語言的術語。target `string` （必選）目標語言的術語。 tm_list `arrays` （可選）使用翻譯記憶功能時需設定的翻譯記憶數組。屬性 source `string` （必選）源語言的語句。target `string` （必選）目標語言的語句。 domains `string` （可選）使用領域提示功能時需設定的領域提示句。領域提示句暫時只支援英文。 Java SDK中為`translationOptions`。通過HTTP調用時，請將 translation_options放入 parameters 對象中。

​OpenAI 相容

請求體

chat響應對象（非流式輸出）

chat響應chunk對象（流式輸出）

​DashScope

請求體

chat響應對象（流式與非流式輸出格式一致）

​錯誤碼

OpenAI 相容

DashScope

錯誤碼