Python開發環境 - Alibaba Cloud SDK

本文以在Windows安裝PyCharm為例，為您介紹Python開發環境搭建步驟。

搭建步驟

訪問PyCharm官網，單擊Download。
在Download頁面，選擇PyCharm Community Edition，單擊Download下載。
雙擊安裝檔案pycharm-community-2024.1.1.exe開始安裝，並根據安裝嚮導完成安裝。
重要
在安裝選項步驟，勾選‘添加“bin”檔案夾到PATH’。
開啟PyCharm，單擊New Project，建立一個新專案用於管理使用Python語言的軟體應用或工具。
在New Project視窗填寫專案資訊。
1. Name：專案名稱，例如pythonProject。
2. Location：專案檔的儲存位置，方便您管理專案檔。
  說明
  Create Git repository：建立Git版本控制倉庫，本樣本不勾選。
  Create a welcome script：建立一個main.py檔案，本樣本不勾選。
3. Interpreter type：運行環境，本樣本選擇Project venv。
  1. Project venv：專案虛擬環境，虛擬環境會將專案的依賴項和Python解譯器隔離開來，可以為每個專案建立獨立的環境，並在其中安裝專案所需的包和依賴項，適用於大多數Python專案。
    Python version：選擇安裝的python解譯器版本，預設為您已安裝的python版本，如果您安裝有多個版本可以手動修改。
  2. Base conda：基礎conda環境，基於Conda（跨平台環境管理器）建立的基礎環境，功能更強大，適用於多語言開發的複雜環境專案，此處暫不做詳細介紹。
  3. Custom environment：自訂環境，手動建立一個全新的Python環境，並手動安裝所需的包和依賴項。
    Environment：Generate new表示產生一個新的環境；Select existing表示選擇一個存在的環境。
    Type：環境的類型，選擇預設Virtualenv。
    Base python：選擇python解譯器版本。
    Location：python環境的儲存位置。
    說明
    Inherit packages from base interpreter：這個環境繼承全域基礎解譯器所安裝的第三方庫。
    Make available to all projects：將這個環境安裝的第三方庫用於所有專案。
按右鍵專案名稱，選擇New->Python File，在新快顯視窗輸入檔案名稱hello_aliyun，選擇Python file，然後按下斷行符號就建立了一個名稱為hello_aliyun.py的檔案。
在右側編輯地區輸入print("hello aliyun!")，單擊右上方運行按鈕，可以在底部Run選項卡看到運行結果hello aliyun!。

使用python和pip命令

在PyCharm視窗底部單擊Terminal選項卡或者按下Alt + F12開啟Terminal。Terminal是PyCharm內建的一個命令列工具，可以執行大部分命令，例如使用python命令可以執行python檔案，使用pip install來安裝第三方庫等等。

後續操作

在搭建完成Python開發環境後，您可以通過以下方式迅速體驗Python的實際應用情境：利用Python進行多種開發操作。以下是一些具體的使用情境及操作指南：

1.使用阿里雲Python SDK調用阿里雲OpenAPI

在調用之前，您需要先擷取訪問憑證AccessKey，建議使用RAM使用者的AccessKey。更多資訊，請參見建立RAM使用者的AccessKey。
重要
擷取RAM使用者的AccessKey之後，還需要在環境變數中設定AccessKey，具體操作步驟請參見在Linux、macOS和Windows系統配置環境變數
登入SDK Center，選擇將要使用的產品，例如您將要調用Elastic Compute Service的DescribeInstanceTypeFamilies介面為例。
在頁面中間的參數配置頁簽，並填寫需要的參數資訊。填寫時請參考右側的文檔頁簽，充分瞭解介面的說明和注意事項（尤其是費用相關資訊），以及各參數的具體含義和使用方法。如DescribeInstanceTypeFamilies介面支援傳入兩個參數，其中RegionId為必填，您可填入cn-qingdao（表示青島地區）；Generation非必填，您可填入ecs-5（表示系列 V 執行個體規格類型系列），參數的詳細取值可在右側文檔中查看，請根據樣本值的格式按照您的需求進行填寫。
在右側的SDK樣本頁面，選擇Python語言，單擊下載完整工程按鈕，下載SDK完整工程至本地並解壓。

程式碼範例：

# -*- coding: utf-8 -*-
import os
import sys

from typing import List

from alibabacloud_ecs20140526.client import Client as Ecs20140526Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ecs20140526 import models as ecs_20140526_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Ecs20140526Client:
        """
        使用AK&SK初始化帳號Client
        @return: Client
        @throws Exception
        """
      
        config = open_api_models.Config(
        # os.environ表示通過環境變數擷取Access Key ID和Access Key Secret
        # 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。,
        access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
        # 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。,
        access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
        )
        config.endpoint = f'ecs.cn-qingdao.aliyuncs.com'
        return Ecs20140526Client(config)

    @staticmethod
    async def main_async(
            args: List[str],
    ) -> None:
        client = Sample.create_client()
        describe_instance_type_families_request = ecs_20140526_models.DescribeInstanceTypeFamiliesRequest(
            region_id='cn-qingdao',
            generation='ecs-5'
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 複製代碼運行請自行列印 API 的傳回值
            await client.describe_instance_type_families_with_options_async(describe_instance_type_families_request, runtime)
        except Exception as error:
            # 此處僅做列印展示，請謹慎對待異常處理，在工程專案中切勿直接忽略異常。
            # 錯誤 message
            print(error.message)
            # 診斷地址
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)


def main(
        args: List[str],
) -> None:
    client = Sample.create_client()
    describe_instance_type_families_request = ecs_20140526_models.DescribeInstanceTypeFamiliesRequest(
        region_id='cn-qingdao',
        generation='ecs-5'
    )
    runtime = util_models.RuntimeOptions()
    try:
        # 複製代碼運行請自行列印 API 的傳回值
        response = client.describe_instance_type_families_with_options(describe_instance_type_families_request, runtime)
        print(response)
    except Exception as error:
        # 此處僅做列印展示，請謹慎對待異常處理，在工程專案中切勿直接忽略異常。
        # 錯誤 message
        print(error.message)
        # 診斷地址
        print(error.data.get("Recommend"))
        UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    main(sys.argv[1:])

運行結果：
使用阿里雲Python SDK調用阿里雲OpenAPI，具體操作，請參見通過IDE使用阿里雲Python SDK。

2.調用通義千問API實現對話功能

百鍊支援通過API調用大模型，涵蓋OpenAI相容介面、DashScope SDK等接入方式。調用服務前您需要開通百鍊，擷取API KEY。具體操作，請參見帳號設定。
重要
在擷取API Key後，需將其配置到環境變數，以避免在代碼中顯式地設定API Key，從而降低泄露風險。具體操作步驟請參見配置API Key到環境變數。
通過運行以下命令安裝OpenAI Python SDK：
```
# 如果運行失敗，您可以將pip替換成pip3再運行
pip install -U openai
```
當終端出現Successfully installed ... openai-x.x.x的提示後，表示您已經成功安裝OpenAI Python SDK。

如您已完成Python及OpenAI的Python SDK安裝，可運行以下範例程式碼以調用通義千問API：

import os
from openai import OpenAI

try:
    client = OpenAI(
        # os.getenv表示通過環境變數擷取API Key，若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx",
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
    )

    completion = client.chat.completions.create(
        model="qwen-plus",
        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}")

輸出結果：
調用通義千問API，具體操作，請參見OpenAI Python SDK。

3.調用DeepSeek API

本段主要介紹在百鍊平台上通過API調用DeepSeek系列模型的方法。其中，deepseek-r1與deepseek-v3各提供100萬個免費Token，部分蒸餾模型可限時免費體驗。

調用服務前您需要開通百鍊，擷取API KEY。具體操作，請參見帳號設定。
重要
在擷取API Key後，需將其配置到環境變數，以避免在代碼中顯式地設定API Key，從而降低泄露風險。具體操作步驟請參見配置API Key到環境變數。
通過運行以下命令安裝OpenAI Python SDK：
```
# 如果運行失敗，您可以將pip替換成pip3再運行
pip install -U openai
```
當終端出現Successfully installed ... openai-x.x.x的提示後，表示您已經成功安裝OpenAI Python SDK。

如果您已完成Python及OpenAI的Python SDK的安裝，可以運行以下範例程式碼以調用DeepSeek模型服務：

import os
from openai import OpenAI

client = OpenAI(
    # os.getenv表示通過環境變數擷取API Key，若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx",
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1"
)

completion = client.chat.completions.create(
    model="deepseek-r1",  # 此處以 deepseek-r1 為例，可按需更換模型名稱。
    messages=[
        {'role': 'user', 'content': '9.9和9.11誰大'}
    ]
)

# 通過reasoning_content欄位列印思考過程
print("思考過程：")
print(completion.choices[0].message.reasoning_content)

# 通過content欄位列印最終答案
print("最終答案：")
print(completion.choices[0].message.content)

輸出結果：
調用DeepSeek API，具體操作，請參見。