Alibaba Cloud SDK:Build a Python development environment on Windows

Get an AccessKey pair. We recommend that you use the AccessKey pair of a Resource Access Management (RAM) user. See Create an AccessKey pair for a RAM user.

Log on to SDK Center and select the service to call.

On the Parameters tab in the middle column, set the request parameters. Refer to the Document tab in the rightmost column for usage notes, parameter descriptions, and billing information. In this example, the DescribeInstanceTypeFamilies operation has two parameters: Check the Document tab for valid parameter values and configure them based on your requirements.

• RegionId (required): Set to a value such as cn-qingdao.

• Generation (optional): Set to a value such as ecs-5 for the V-series instance family.

On the SDK Sample Code tab in the rightmost column, select Python and click Download Project to download the complete SDK project. Decompress the package after downloading.

The downloaded project contains the following sample code:

# -*- 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:
        """
        Use your AccessKey ID and AccessKey secret to initialize the client.
        @return: Client
        @throws Exception
        """

        config = open_api_models.Config(
        # os.environ specifies that the AccessKey ID and AccessKey secret are obtained from an environment variable.
        # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured. ,
        access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
        # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured. ,
        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:
            # If you copy and run the sample code, write your own code to display the response of the API operation.
            await client.describe_instance_type_families_with_options_async(describe_instance_type_families_request, runtime)
        except Exception as error:
            # Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error message displayed in this example is for reference only.
            # The error message.
            print(error.message)
            # The URL of the corresponding error diagnostics page.
            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:
        # If you copy and run the sample code, write your own code to display the response of the API operation.
        response = client.describe_instance_type_families_with_options(describe_instance_type_families_request, runtime)
        print(response)
    except Exception as error:
        # Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error message displayed in this example is for reference only.
        # The error message.
        print(error.message)
        # The URL of the corresponding error diagnostics page.
        print(error.data.get("Recommend"))
        UtilClient.assert_as_string(error.message)


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

Run the project to get results similar to the following:

For more details on using the SDK, see Use the Alibaba Cloud Python SDK in an IDE.

Activate Alibaba Cloud Model Studio and get an API key. See Account Settings.

Install the OpenAI Python SDK: If the output includes Successfully installed ... openai-x.x.x, the SDK is installed.

# If the execution fails, replace pip with pip3 and re-run the command.
pip install -U openai

Run the following sample code to call the Qwen API:

import os
from openai import OpenAI

try:
    client = OpenAI(
        # os.getenv obtains the API key from environment variables. If you have not configured environment variables, replace the following line with your Alibaba Cloud Model Studio 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': 'Who are you?'}
        ]
    )
    print(completion.choices[0].message.content)
except Exception as e:
    print(f"Error message: {e}")

Expected output:

For more information, see OpenAI Python SDK.

Activate Alibaba Cloud Model Studio and get an API key. See Manage account.

Install the OpenAI Python SDK: If the output includes Successfully installed ... openai-x.x.x, the SDK is installed.

# If the execution fails, replace pip with pip3 and re-run the command.
pip install -U openai

Run the following sample code to call DeepSeek:

import os
from openai import OpenAI

client = OpenAI(
    # os.getenv obtains the API key from environment variables. If you have not configured environment variables, replace the following line with your Alibaba Cloud Model Studio 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",  # This example uses deepseek-r1. Change the model name as needed.
    messages=[
        {'role': 'user', 'content': 'Which is larger, 9.9 or 9.11?'}
    ]
)

# Print the reasoning process using the reasoning_content field.
print("Reasoning process:")
print(completion.choices[0].message.reasoning_content)

# Print the final answer using the content field.
print("Final answer:")
print(completion.choices[0].message.content)

Expected output:

Call the DeepSeek API. For more information, see .