すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud SDK:Windows で Python 開発環境を構築する

最終更新日:Mar 01, 2026

Windows に PyCharm をセットアップし、初めての Alibaba Cloud SDK または API 呼び出しを実行します。

前提条件

開始する前に、以下のものがあることを確認してください:

  • Python がインストールされている Windows コンピューター

  • Alibaba Cloud アカウント

  • (SDK を使用する場合) Resource Access Management (RAM) ユーザーの AccessKey ペア。 詳細については、「RAM ユーザーの AccessKey ペアの作成」をご参照ください。

PyCharm のインストール

  1. PyCharm のダウンロードページにアクセスし、[ダウンロード] をクリックします。

    image

  2. PyCharm Community Edition を見つけて、[ダウンロード] をクリックします。

    image

  3. ダウンロードしたインストールファイル (pycharm-community-2024.1.1.exe) をダブルクリックし、ウィザードに従ってインストールを完了します。

    重要

    [インストールオプション] のステップで、[bin フォルダーを PATH に追加] を選択します。

プロジェクトの作成

  1. PyCharm を開き、[新規プロジェクト] をクリックします。

    image

  2. [新規プロジェクト] ダイアログボックスで、以下の設定を構成します:

    • [名前]:プロジェクト名を入力します。 例: pythonProject

    • [場所]:プロジェクトファイルを保存する場所を指定します。

    説明

    [Git リポジトリの作成] は、バージョン管理用の Git リポジトリを作成します。このオプションは、この例では選択されていません。

    [ウェルカムスクリプトの作成] は main.py ファイルを作成します。この例では、このオプションは選択されていません。

  3. [インタープリタータイプ] で、以下のいずれかのオプションを選択します:

    • [Project venv] (この例で使用):プロジェクトの依存関係をシステムの Python インタープリターから分離する仮想環境を作成します。 このオプションは、ほとんどの Python プロジェクトに適しています。 [Python バージョン] は、デフォルトでインストールされている Python のバージョンになります。 複数のバージョンがインストールされている場合は、使用するバージョンを選択します。 image

    • [Base conda]:conda クロスプラットフォーム環境マネージャーを使用します。 このオプションは、複雑な環境での多言語開発に適しています。

    • [カスタム環境]:手動で Python 環境を作成および構成します。

      説明

      [ベースインタープリターからパッケージを継承] を選択すると、グローバルインタープリターのサードパーティライブラリがこの環境で利用可能になります。

      [すべてのプロジェクトで利用可能にする] を選択すると、この環境にインストールされたライブラリがすべてのプロジェクトで共有されます。

      image

      • 環境[新規作成] では新しい環境が作成されます。[既存を選択] では既存の環境が使用されます。

      • [タイプ]:環境のタイプです。 デフォルトでは [Virtualenv] が選択されています。

      • ベース Python: Python インタープリターのバージョンです。

      • [場所]:Python 環境を保存する場所です。

Python ファイルの作成と実行

  1. プロジェクト名を右クリックし、[新規] > [Python ファイル] を選択します。 ファイル名を入力し、[Python ファイル] を選択して Enter キーを押します。 この例では、hello_aliyun.py という名前のファイルを作成します。

    image

    image

  2. エディターに print("hello aliyun!") と入力し、右上隅の [実行] アイコンをクリックします。 コンソールの下部にある [実行] ウィンドウに出力 hello aliyun! が表示されます。

    image

ターミナルでの Python および pip コマンドの使用

PyCharm コンソールの下部にある [ターミナル] アイコンをクリックするか、Alt+F12 を押して、組み込みのコマンドラインインターフェイス (CLI) を開きます。 ターミナルは、スクリプトを実行するための python や、サードパーティライブラリをインストールするための pip install など、ほとんどのコマンドをサポートしています。

image

次のステップ

Python 開発環境をセットアップした後、以下のシナリオを試して Alibaba Cloud サービスでの構築を開始してください。

Python SDK を使用した Alibaba Cloud API 操作の呼び出し

Alibaba Cloud SDK for Python を使用して API 操作を呼び出します。 この例では、Elastic Compute Service (ECS) の DescribeInstanceTypeFamilies 操作を呼び出します。

認証の設定

  1. AccessKey ペアを取得します。 Resource Access Management (RAM) ユーザーの AccessKey ペアを使用することを推奨します。 詳細については、「RAM ユーザーの AccessKey ペアの作成」をご参照ください。

    重要

    AccessKey ペアを環境変数として設定します。 認証情報をコードにハードコーディングしないでください。 設定手順については、「Linux、macOS、Windows での環境変数の設定」をご参照ください。

SDK サンプルコードの生成と実行

  1. ログインして、SDK Center から呼び出すサービスを選択します。

  2. 中央の列の [パラメーター] タブで、リクエストパラメーターを設定します。 使用上の注意、パラメーターの説明、課金情報については、右端の列の [ドキュメント] タブをご参照ください。 この例では、DescribeInstanceTypeFamilies 操作には 2 つのパラメーターがあります。 [ドキュメント] タブで有効なパラメーター値を確認し、要件に基づいて設定します。

    • RegionId (必須):cn-qingdao などの値に設定します。

    • Generation (任意):V シリーズインスタンスファミリーの場合は ecs-5 などの値に設定します。

    image

  3. 右端の列の [SDK サンプルコード] タブで [Python] を選択し、[プロジェクトのダウンロード] をクリックして完全な SDK プロジェクトをダウンロードします。 ダウンロード後、パッケージを解凍します。

    image

  4. ダウンロードしたプロジェクトには、以下のサンプルコードが含まれています:

    # -*- 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:
            """
            AccessKey ID と AccessKey Secret を使用してクライアントを初期化します。
            @return: Client
            @throws Exception
            """
    
            config = open_api_models.Config(
            # os.environ は、AccessKey ID と AccessKey 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:
                # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例で表示されるエラーメッセージは参照用です。
                # エラーメッセージ。
                print(error.message)
                # 対応するエラー診断ページの URL。
                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:
            # 実際のビジネスシナリオに基づいて例外を慎重に処理し、プロジェクトで例外を無視しないでください。 この例で表示されるエラーメッセージは参照用です。
            # エラーメッセージ。
            print(error.message)
            # 対応するエラー診断ページの URL。
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)
    
    
    if __name__ == '__main__':
        main(sys.argv[1:])
  5. プロジェクトを実行すると、以下のような結果が得られます:

    image

  6. SDK の使用方法の詳細については、「IDE での Alibaba Cloud Python SDK の使用」をご参照ください。

Qwen API の呼び出し

Alibaba Cloud Model Studio は、OpenAI 互換 API および DashScope SDK を介した大規模言語モデル (LLM) の呼び出しをサポートしています。

認証の設定

  1. Alibaba Cloud Model Studio を有効化し、API キーを取得します。「アカウント設定」を参照してください。

    重要

    コード内に API キーを露出させないよう、API キーを環境変数として設定してください。See API キーを環境変数として設定する.

SDK のインストールとサンプルコードの実行

  1. OpenAI Python SDK をインストールします。 出力に Successfully installed ... openai-x.x.x が含まれている場合、SDK はインストールされています。

    # 実行に失敗した場合は、pip を pip3 に置き換えてコマンドを再実行してください。
    pip install -U openai

    image

  2. 以下のサンプルコードを実行して Qwen API を呼び出します:

    import os
    from openai import OpenAI
    
    try:
        client = OpenAI(
            # os.getenv は環境変数から API キーを取得します。 環境変数を設定していない場合は、次の行を Alibaba Cloud Model Studio の API キーに置き換えてください: 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': 'Who are you?'}
            ]
        )
        print(completion.choices[0].message.content)
    except Exception as e:
        print(f"Error message: {e}")
  3. 期待される出力:

    image

  4. 詳細については、「OpenAI Python SDK」をご参照ください。

DeepSeek API の呼び出し

Alibaba Cloud Model Studio プラットフォームを介して DeepSeek モデルを呼び出します。 deepseek-r1 および deepseek-v3 モデルは、それぞれ 100 万の無料トークンを提供します。 一部の蒸留モデルは、期間限定の無料トライアルで利用できます。

認証の設定

  1. Alibaba Cloud Model Studio を有効化し、API キーを取得します。詳細については、「アカウントの管理」をご参照ください。

    重要

    コード内で公開しないように、API キーを環境変数として設定してください。詳細については「API キーを環境変数として設定する」をご参照ください。

SDK のインストールとサンプルコードの実行

  1. OpenAI Python SDK をインストールします。 出力に Successfully installed ... openai-x.x.x が含まれている場合、SDK はインストールされています。

    # 実行に失敗した場合は、pip を pip3 に置き換えてコマンドを再実行してください。
    pip install -U openai

    image

  2. 以下のサンプルコードを実行して DeepSeek を呼び出します:

    import os
    from openai import OpenAI
    
    client = OpenAI(
        # os.getenv は環境変数から API キーを取得します。 環境変数を設定していない場合は、次の行を Alibaba Cloud Model Studio の API キーに置き換えてください: 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': 'Which is larger, 9.9 or 9.11?'}
        ]
    )
    
    # reasoning_content フィールドを使用して推論プロセスを出力します。
    print("Reasoning process:")
    print(completion.choices[0].message.reasoning_content)
    
    # content フィールドを使用して最終的な回答を出力します。
    print("Final answer:")
    print(completion.choices[0].message.content)
  3. 期待される出力:

    image

  4. DeepSeek API を呼び出します。詳細については、「」をご参照ください。