Alibaba Cloud Model Studio：首次調用千問API

OpenAI Python SDK

如果您安裝完成了Python以及OpenAI的Python SDK，可以參考以下步驟發送您的API請求。

1. 建立一個檔案，命名為hello_qwen.py。
2. 將以下代碼複製到hello_qwen.py中並儲存。

import os
from openai import OpenAI

try:
    client = OpenAI(
        # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為: api_key="sk-xxx",
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )

    completion = client.chat.completions.create(
        model="qwen3.8-max",
        messages=[
            {'role': 'system', 'content': 'You are a helpful assistant.'},
            {'role': 'user', 'content': '你是誰？'}
        ]
    )
    print(completion.choices[0].message.content)
except Exception as e:
    print(f"錯誤資訊：{e}")
    print("請參考文檔：https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

使用美國（維吉尼亞）地區時，接入網域名稱為{WorkspaceId}.us-east-1.maas.aliyuncs.com，與華北2（北京）、新加坡地區的格式相同。新加坡、美國（維吉尼亞）與華北2（北京）的 API Key 按地區隔離，不可跨地區使用。

調用時請將{WorkspaceId}替換為真實的業務空間ID。

import os
from openai import OpenAI

try:
    client = OpenAI(
        # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為: api_key="sk-xxx",
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # 以下為美國（維吉尼亞）地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
        base_url="https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1",
    )

    completion = client.chat.completions.create(
        model="qwen3.8-max",  # 模型列表: https://www.alibabacloud.com/help/model-studio/getting-started/models
        messages=[
            {'role': 'system', 'content': 'You are a helpful assistant.'},
            {'role': 'user', 'content': '你是誰？'}
        ]
    )
    print(completion.choices[0].message.content)
except Exception as e:
    print(f"錯誤資訊：{e}")
    print("請參考文檔：https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

3. 通過命令列運行python hello_qwen.py或python3 hello_qwen.py。

   若提示No such file or directory，則需在檔案名稱前指定具體檔案路徑。

   運行後您將會看到輸出結果：

我是阿里雲開發的一款超大規模語言模型，我叫千問。

DashScope Python SDK

如果您安裝完成了Python以及DashScope的Python SDK，可以參考以下步驟發送您的API請求。

1. 建立一個檔案，命名為hello_qwen.py。
2. 將以下代碼複製到hello_qwen.py中並儲存。

import os
from dashscope import MultiModalConversation
import dashscope

# 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'
messages = [
    {'role': 'system', 'content': [{'text': 'You are a helpful assistant.'}]},
    {'role': 'user', 'content': [{'text': '你是誰？'}]}
]
response = MultiModalConversation.call(
    # 若沒有配置環境變數，請用阿里雲百鍊API Key將下行替換為: api_key = "sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    model="qwen3.8-max",
    messages=messages,
)

if response.status_code == 200:
    print(response.output.choices[0].message.content[0]["text"])
else:
    print(f"HTTP返回碼：{response.status_code}")
    print(f"錯誤碼：{response.code}")
    print(f"錯誤資訊：{response.message}")
    print("請參考文檔：https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

3. 通過命令列運行python hello_qwen.py或python3 hello_qwen.py。

   說明本樣本使用的運行命令需在Python檔案所在目錄執行，如果想要在任意位置執行，請在檔案名稱前指定具體檔案路徑。

   運行後您將會看到輸出結果：

我是來自阿里雲的大規模語言模型，我叫千問。

OpenAI相容-HTTP

程式碼範例中的URL以新加坡地區為例，調用時請將{WorkspaceId}替換為真實的業務空間ID。如果使用華北2（北京）地區的模型，需要將URL替換為https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions。

您可以運行以下命令發送API請求：

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\": \"qwen3.8-max\",
    \"messages\": [
        {
            \"role\": \"system\",
            \"content\": \"You are a helpful assistant.\"
        },
        {
            \"role\": \"user\",
            \"content\": \"你是誰？\"
        }
    ]
}"

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": "qwen3.8-max",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "你是誰？"
        }
    ]
}'

發送API請求後，可以得到以下回複：

{
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "我是來自阿里雲的大規模語言模型，我叫千問。"
            },
            "finish_reason": "stop",
            "index": 0,
            "logprobs": null
        }
    ],
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 22,
        "completion_tokens": 16,
        "total_tokens": 38
    },
    "created": 1728353155,
    "system_fingerprint": null,
    "model": "qwen3.8-max",
    "id": "chatcmpl-39799876-eda8-9527-9e14-2214d641cf9a"
}

DashScope-HTTP

程式碼範例中的URL以“新加坡”地區為例，調用時請將{WorkspaceId}替換為真實的業務空間ID：

• 如果使用“美國（維吉尼亞）”地區的模型，需要將URL替換為https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation。
• 如果使用“華北2（北京）”地區的模型，需要將URL替換為https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation，請將WorkspaceId替換為業務空間ID。
• 如果使用“日本（東京）”地區的模型，需要將URL替換為https://{WorkspaceId}.ap-northeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation，請將WorkspaceId替換為業務空間ID。

您可以運行以下命令發送API請求：

curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation" ^
-H "Authorization: Bearer %DASHSCOPE_API_KEY%" ^
-H "Content-Type: application/json" ^
-d "{
  \"model\": \"qwen3.8-max\",
  \"input\": {
    \"messages\": [
      {
        \"role\": \"system\",
        \"content\": [{\"text\": \"You are a helpful assistant.\"}]
      },
      {
        \"role\": \"user\",
        \"content\": [{\"text\": \"你是誰？\"}]
      }
    ]
  },
  \"parameters\": {
    \"result_format\": \"message\"
  }
}"

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.8-max",
    "input":{
        "messages":[
            {
                "role": "system",
                "content": [{"text": "You are a helpful assistant."}]
            },
            {
                "role": "user",
                "content": [{"text": "你是誰？"}]
            }
        ]
    },
    "parameters": {
        "result_format":"message"
    }
}'

發送API請求後，可以得到以下回複：

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": "我是來自阿里雲的大規模語言模型，我叫千問。"
                }
            }
        ]
    },
    "usage": {
        "total_tokens": 38,
        "output_tokens": 16,
        "input_tokens": 22
    },
    "request_id": "87f776d7-3c82-9d39-b238-d1ad38c9b6a9"
}