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

1. 呼び出しを行う前に、AccessKey ペアが取得されていることを確認してください。Resource Access Management (RAM) ユーザーの AccessKey ペアを使用することをお勧めします。詳細については、「AccessKey ペアを作成する」トピックの「RAM ユーザーの AccessKey ペアを作成する」セクションをご参照ください。

   重要

   RAM ユーザーの AccessKey ペアを取得したら、環境変数に AccessKey ペアを設定する必要があります。詳細については、「Linux、macOS、および Windows で環境変数を設定する」をご参照ください。

2. SDK Center にログインし、使用するサービスを選択します。この例では、Elastic Compute Service (ECS) の DescribeInstanceTypeFamilies API オペレーションが呼び出されます。

3. 中央の列にある [ Parameters ] タブで、ビジネス要件に基づいてパラメータを指定します。パラメータを指定する際は、右端の列にある [ Document ] タブの情報をお読みください。操作の使用方法に関する注意事項と各パラメータの説明を理解していることを確認してください。課金関連の情報に注意してください。この例では、DescribeInstanceTypeFamilies オペレーションは 2 つの リクエストパラメータをサポートしています。RegionId パラメータには cn-qingdao などの値を指定する必要があります。Generation パラメータはオプションです。このパラメータを ecs-5 に設定できます。これは V シリーズインスタンスファミリーを示します。パラメータの有効な値は、[ Document ] タブで確認できます。実際のビジネス要件に基づいてパラメータを設定します。

4. 右端の列にある [ SDK Sample Code ] タブで、プログラミング言語として [ Python ] を選択し、[ Download Project ] をクリックして、完全な SDK プロジェクトをコンピュータにダウンロードします。次に、パッケージを解凍します。

5. サンプルコード:

   # -*- 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 シークレットを使用してクライアントを初期化します。
           @return: Client
           @throws Exception
           """
         
           config = open_api_models.Config(
           # os.environ は、AccessKey ID と AccessKey シークレットが環境変数から取得されることを指定します。
           # 必須。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:])

6. 結果:

7. Alibaba Cloud SDK for Python を使用します。詳細については、「IDE で Alibaba Cloud SDK for Python を使用する」をご参照ください。

1. Alibaba Cloud Model Studio では、API オペレーションを実行することで大規模言語モデル (LLM) を呼び出すことができます。Alibaba Cloud Model Studio は、API オペレーションと DashScope SDK と互換性があります。呼び出しを行う前に、Alibaba Cloud Model Studio をアクティブ化し、API キーを取得します。詳細については、「アカウントを管理する」をご参照ください。

   重要

   API キーを取得したら、環境変数に指定します。API キーの漏洩を防ぐため、コードで API キーを公開しないでください。詳細については、「API キーを環境変数として設定する」をご参照ください。

2. 次のコマンドを実行して、SDK for Python をインストールします。

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

   「Successfully installed ... openai-x.x.x」メッセージが表示されたら、SDK for Python がインストールされています。

3. Python と SDK for Python をインストールしたら、次のサンプルコードを実行して Qwen API を呼び出すことができます。

   import os
   from openai import OpenAI
   
   try:
       client = OpenAI(
           # os.getenv は、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}")
       print("Reference: https://www.alibabacloud.com/help/zh/model-studio/developer-reference/error-code")

4. 出力:

5. Qwen API の呼び出し方法の詳細については、「OpenAI Python SDK」をご参照ください。

このセクションでは、Alibaba Cloud Model Studio で API 呼び出しを通じて DeepSeek を呼び出す方法について説明します。 deepseek-r1 と deepseek-v3 は、100 万 トークンを無料で提供します。一部の蒸留モデルは、期間限定で無料です。

1. 呼び出しを行う前に、Alibaba Cloud Model Studio をアクティブ化し、API キーを取得します。詳細については、「アカウントを管理する」をご参照ください。

   重要

   API キーを取得したら、環境変数に指定します。API キーの漏洩を防ぐため、コードで API キーを公開しないでください。詳細については、「API キーを環境変数として設定する」をご参照ください。

2. 次のコマンドを実行して、SDK for Python をインストールします。

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

   「Successfully installed ... openai-x.x.x」メッセージが表示されたら、SDK for Python がインストールされています。

3. Python と SDK for Python をインストールしたら、次のサンプルコードを実行して DeepSeek を呼び出すことができます。

   import os
   from openai import OpenAI
   
   client = OpenAI(
       # os.getenv は、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': '9.9 と 9.11 のどちらが大きいですか?''}
       ]
   )
   
   # reasoning_content フィールドを使用して、参照プロセスを出力します。
   print("参照プロセス:")
   print(completion.choices[0].message.reasoning_content)
   
   # content フィールドを使用して、最終的な回答を出力します。
   print("最終的な回答:")
   print(completion.choices[0].message.content)

4. 出力:

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