全部产品
Search
文档中心

Alibaba Cloud SDK:Bangun lingkungan pengembangan Python di Windows

更新时间:Mar 01, 2026

Siapkan PyCharm di Windows dan jalankan panggilan SDK atau API Alibaba Cloud pertama Anda.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Instal PyCharm

  1. Buka halaman unduhan PyCharm dan klik Download.

    image

  2. Temukan PyCharm Community Edition dan klik Download.

    image

  3. Klik ganda file instalasi yang telah diunduh (pycharm-community-2024.1.1.exe) dan ikuti panduan wizard untuk menyelesaikan instalasi.

    Penting

    Pada langkah Installation Options, pilih Add the bin folder to PATH.

Buat proyek

  1. Buka PyCharm dan klik New Project.

    image

  2. Pada kotak dialog New Project, konfigurasikan pengaturan berikut:

    • Name: Masukkan nama proyek. Contoh: pythonProject.

    • Location: Tentukan lokasi penyimpanan file proyek.

    Catatan

    Create Git repository membuat repositori Git untuk kontrol versi. Opsi ini tidak dipilih dalam contoh ini.

    Create a welcome script membuat file main.py. Opsi ini tidak dipilih dalam contoh ini.

  3. Untuk Interpreter type, pilih salah satu opsi berikut:

    • Project venv (digunakan dalam contoh ini): Membuat lingkungan virtual yang mengisolasi dependensi proyek dari interpreter Python sistem. Opsi ini cocok untuk sebagian besar proyek Python. Python version secara default menggunakan versi Python yang telah diinstal. Jika terdapat beberapa versi yang terinstal, pilih salah satu yang akan digunakan. image

    • Base conda: Menggunakan manajer lingkungan lintas platform conda. Opsi ini cocok untuk pengembangan multi-bahasa di lingkungan kompleks.

    • Custom environment: Buat dan konfigurasikan lingkungan Python secara manual.

      Catatan

      Inherit packages from base interpreter menyediakan pustaka pihak ketiga dari interpreter global di lingkungan ini.

      Make available to all projects membagikan pustaka yang diinstal di lingkungan ini ke semua proyek.

      image

      • Environment: Generate new membuat lingkungan baru. Select existing menggunakan lingkungan yang sudah ada.

      • Type: Jenis lingkungan. Virtualenv dipilih secara default.

      • Base python: Versi interpreter Python.

      • Location: Lokasi penyimpanan lingkungan Python.

Buat dan jalankan file Python

  1. Klik kanan nama proyek dan pilih New > Python File. Masukkan nama file, pilih Python file, lalu tekan Enter. Contoh ini membuat file bernama hello_aliyun.py.

    image

    image

  2. Pada editor, masukkan print("hello aliyun!") dan klik ikon Run di pojok kanan atas. Output hello aliyun! akan muncul di jendela Run di bagian bawah konsol.

    image

Gunakan terminal untuk perintah Python dan pip

Klik ikon Terminal di bagian bawah konsol PyCharm, atau tekan Alt+F12, untuk membuka antarmuka baris perintah (CLI) bawaan. Terminal mendukung sebagian besar perintah, termasuk python untuk menjalankan skrip dan pip install untuk menginstal pustaka pihak ketiga.

image

Langkah selanjutnya

Setelah menyiapkan lingkungan pengembangan Python Anda, coba skenario berikut untuk mulai membangun dengan layanan Alibaba Cloud.

Panggil operasi API Alibaba Cloud dengan SDK Python

Gunakan Alibaba Cloud SDK untuk Python guna memanggil operasi API. Contoh ini memanggil operasi DescribeInstanceTypeFamilies dari Elastic Compute Service (ECS).

Siapkan autentikasi

  1. Dapatkan Pasangan Kunci Akses. Kami menyarankan Anda menggunakan Pasangan Kunci Akses milik Pengguna Resource Access Management (RAM). Lihat Buat Pasangan Kunci Akses untuk Pengguna RAM.

    Penting

    Konfigurasikan Pasangan Kunci Akses sebagai variabel lingkungan. Jangan hardcode kredensial di dalam kode Anda. Untuk petunjuk penyiapan, lihat Konfigurasi variabel lingkungan di Linux, macOS, dan Windows.

Hasilkan dan jalankan kode contoh SDK

  1. Masuk ke SDK Center dan pilih layanan yang akan dipanggil.

  2. Pada tab Parameters di kolom tengah, atur parameter permintaan. Lihat tab Document di kolom paling kanan untuk catatan penggunaan, deskripsi parameter, dan informasi penagihan. Dalam contoh ini, operasi DescribeInstanceTypeFamilies memiliki dua parameter: Periksa tab Document untuk nilai parameter yang valid dan konfigurasikan sesuai kebutuhan Anda.

    • RegionId (wajib): Atur ke nilai seperti cn-qingdao.

    • Generation (opsional): Atur ke nilai seperti ecs-5 untuk keluarga instans seri V.

    image

  3. Pada tab SDK Sample Code di kolom paling kanan, pilih Python dan klik Download Project untuk mengunduh proyek SDK lengkap. Ekstrak paket setelah diunduh.

    image

  4. Proyek yang diunduh berisi kode contoh berikut:

    # -*- 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:
            """
            Gunakan ID AccessKey dan Rahasia AccessKey Anda untuk menginisialisasi client.
            @return: Client
            @throws Exception
            """
    
            config = open_api_models.Config(
            # os.environ menentukan bahwa ID AccessKey dan Rahasia AccessKey diambil dari variabel lingkungan.
            # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah dikonfigurasi. ,
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah dikonfigurasi. ,
            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:
                # Jika Anda menyalin dan menjalankan kode contoh ini, tulis kode Anda sendiri untuk menampilkan respons operasi API.
                await client.describe_instance_type_families_with_options_async(describe_instance_type_families_request, runtime)
            except Exception as error:
                # Tangani exception dengan hati-hati berdasarkan skenario bisnis aktual Anda dan jangan abaikan exception dalam proyek Anda. Pesan error yang ditampilkan dalam contoh ini hanya sebagai referensi.
                # Pesan error.
                print(error.message)
                # URL halaman diagnostik error yang sesuai.
                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:
            # Jika Anda menyalin dan menjalankan kode contoh ini, tulis kode Anda sendiri untuk menampilkan respons operasi API.
            response = client.describe_instance_type_families_with_options(describe_instance_type_families_request, runtime)
            print(response)
        except Exception as error:
            # Tangani exception dengan hati-hati berdasarkan skenario bisnis aktual Anda dan jangan abaikan exception dalam proyek Anda. Pesan error yang ditampilkan dalam contoh ini hanya sebagai referensi.
            # Pesan error.
            print(error.message)
            # URL halaman diagnostik error yang sesuai.
            print(error.data.get("Recommend"))
            UtilClient.assert_as_string(error.message)
    
    
    if __name__ == '__main__':
        main(sys.argv[1:])
  5. Jalankan proyek untuk mendapatkan hasil yang mirip dengan berikut:

    image

  6. Untuk detail lebih lanjut tentang penggunaan SDK, lihat Use the Alibaba Cloud Python SDK in an IDE.

Panggil API Qwen

Alibaba Cloud Model Studio mendukung pemanggilan model bahasa besar (LLM) melalui API yang kompatibel dengan OpenAI dan SDK DashScope.

Siapkan autentikasi

  1. Aktifkan Alibaba Cloud Model Studio dan dapatkan Kunci API. Lihat Account Settings.

    Penting

    Atur Kunci API sebagai variabel lingkungan untuk menghindari eksposur di dalam kode Anda. Lihat Set API key as environment variable.

Instal SDK dan jalankan kode contoh

  1. Instal OpenAI Python SDK: Jika output mencakup Successfully installed ... openai-x.x.x, berarti SDK telah berhasil diinstal.

    # Jika eksekusi gagal, ganti pip dengan pip3 dan jalankan ulang perintah.
    pip install -U openai

    image

  2. Jalankan kode contoh berikut untuk memanggil API Qwen:

    import os
    from openai import OpenAI
    
    try:
        client = OpenAI(
            # os.getenv mengambil Kunci API dari variabel lingkungan. Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Alibaba Cloud Model Studio Anda: 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. Output yang diharapkan:

    image

  4. Untuk informasi lebih lanjut, lihat OpenAI Python SDK.

Panggil API DeepSeek

Panggil model DeepSeek melalui platform Alibaba Cloud Model Studio. Model deepseek-r1 dan deepseek-v3 masing-masing menawarkan 1 juta token gratis. Beberapa model distill tersedia untuk uji coba gratis dalam waktu terbatas.

Siapkan autentikasi

  1. Aktifkan Alibaba Cloud Model Studio dan dapatkan Kunci API. Lihat Manage account.

    Penting

    Atur Kunci API sebagai variabel lingkungan untuk menghindari eksposur di dalam kode Anda. Lihat Configure the API key as an environment variable.

Instal SDK dan jalankan kode contoh

  1. Instal OpenAI Python SDK: Jika output mencakup Successfully installed ... openai-x.x.x, berarti SDK telah berhasil diinstal.

    # Jika eksekusi gagal, ganti pip dengan pip3 dan jalankan ulang perintah.
    pip install -U openai

    image

  2. Jalankan kode contoh berikut untuk memanggil DeepSeek:

    import os
    from openai import OpenAI
    
    client = OpenAI(
        # os.getenv mengambil Kunci API dari variabel lingkungan. Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Alibaba Cloud Model Studio Anda: 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",  # Contoh ini menggunakan deepseek-r1. Ubah nama model sesuai kebutuhan.
        messages=[
            {'role': 'user', 'content': 'Which is larger, 9.9 or 9.11?'}
        ]
    )
    
    # Cetak proses penalaran menggunakan bidang reasoning_content.
    print("Reasoning process:")
    print(completion.choices[0].message.reasoning_content)
    
    # Cetak jawaban akhir menggunakan bidang content.
    print("Final answer:")
    print(completion.choices[0].message.content)
  3. Output yang diharapkan:

    image

  4. Panggil API DeepSeek. Untuk informasi lebih lanjut, lihat .