Alibaba Cloud SDK：Membangun lingkungan pengembangan Python di Windows

1. Sebelum melakukan panggilan, pastikan pasangan AccessKey telah diperoleh. Kami merekomendasikan penggunaan pasangan AccessKey dari Pengguna Resource Access Management (RAM). Untuk informasi lebih lanjut, lihat bagian Buat pasangan AccessKey untuk pengguna RAM dari topik "Buat pasangan AccessKey".

   Penting

   Setelah mendapatkan pasangan AccessKey dari pengguna RAM, konfigurasikan pasangan tersebut di variabel lingkungan. Untuk informasi lebih lanjut, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.

2. Masuk ke SDK Center dan pilih layanan yang ingin digunakan. Dalam contoh ini, operasi API DescribeInstanceTypeFamilies dari Elastic Compute Service (ECS) dipanggil.

3. Di tab Parameters di kolom tengah, tentukan parameter sesuai kebutuhan bisnis Anda. Saat menentukan parameter, baca informasi di tab Document di kolom paling kanan. Pastikan Anda memahami catatan penggunaan operasi dan deskripsi setiap parameter. Perhatikan informasi terkait tagihan. Dalam contoh ini, operasi DescribeInstanceTypeFamilies mendukung dua parameter permintaan. Tentukan nilai seperti cn-qingdao untuk parameter RegionId. Parameter Generation bersifat opsional. Anda dapat mengatur parameter ini ke ecs-5, yang menunjukkan keluarga instance seri-V. Konfigurasikan parameter berdasarkan kebutuhan bisnis aktual Anda.

4. Di tab SDK Sample Code di kolom paling kanan, pilih Python sebagai bahasa pemrograman dan klik Download Project untuk mengunduh proyek SDK lengkap ke komputer Anda. Kemudian, ekstrak paket tersebut.

5. Contoh kode:

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

6. Hasil:

7. Gunakan Alibaba Cloud SDK untuk Python. Untuk informasi lebih lanjut, lihat Use Alibaba Cloud SDKs for Python in an IDE.

1. Alibaba Cloud Model Studio memungkinkan Anda memanggil model bahasa besar (LLM) melalui operasi API. Alibaba Cloud Model Studio kompatibel dengan operasi API dan SDK DashScope. Sebelum melakukan panggilan, aktifkan Alibaba Cloud Model Studio dan peroleh kunci API. Untuk informasi lebih lanjut, lihat Kelola akun.

   Penting

   Setelah mendapatkan kunci API, tentukan di variabel lingkungan. Cegah kebocoran kunci API, jangan paparkan kunci API di dalam kode. Untuk informasi lebih lanjut, lihat Set API key as environment variable.

2. Jalankan perintah berikut untuk menginstal SDK untuk Python:

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

   Jika Anda menerima pesan "Successfully installed ... openai-x.x.x", SDK untuk Python telah diinstal.

3. Setelah menginstal Python dan SDK untuk Python, Anda dapat menjalankan kode sampel berikut untuk memanggil API Qwen:

   import os
   from openai import OpenAI
   
   try:
       client = OpenAI(
           # os.getenv menunjukkan bahwa kunci API diperoleh dari variabel lingkungan. Jika Anda tidak mengonfigurasi variabel lingkungan, ganti pengaturan berikut dengan 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"Pesan kesalahan: {e}")
       print("Referensi: https://www.alibabacloud.com/help/zh/model-studio/developer-reference/error-code")

4. Output:

5. Untuk informasi lebih lanjut tentang cara memanggil API Qwen, lihat OpenAI Python SDK.

Bagian ini menjelaskan cara memanggil DeepSeek melalui panggilan API di Alibaba Cloud Model Studio. deepseek-r1 dan deepseek-v3 menyediakan 1 juta token gratis. Beberapa model penyulingan gratis untuk periode waktu terbatas.

1. Sebelum melakukan panggilan, aktifkan Alibaba Cloud Model Studio dan peroleh kunci API. Untuk informasi lebih lanjut, lihat Kelola akun.

   Penting

   Setelah mendapatkan kunci API, tentukan di variabel lingkungan. Cegah kebocoran kunci API, jangan paparkan kunci API di dalam kode. Untuk informasi lebih lanjut, lihat Set API key as environment variable.

2. Jalankan perintah berikut untuk menginstal SDK untuk Python:

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

   Jika Anda menerima pesan "Successfully installed ... openai-x.x.x", SDK untuk Python telah diinstal.

3. Setelah menginstal Python dan SDK untuk Python, Anda dapat menjalankan kode sampel berikut untuk memanggil DeepSeek:

   import os
   from openai import OpenAI
   
   client = OpenAI(
       # os.getenv menunjukkan bahwa kunci API diperoleh dari variabel lingkungan. Jika Anda tidak mengonfigurasi variabel lingkungan, ganti pengaturan berikut dengan 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",  # Dalam contoh ini, deepseek-r1 dipanggil. Anda dapat menentukan nama model yang ingin Anda gunakan. 
       messages=[
           {'role': 'user', 'content': 'Mana yang lebih besar, 9.9 atau 9.11?'}
       ]
   )
   
   # Gunakan bidang reasoning_content untuk mencetak proses referensi.
   print("Proses referensi:")
   print(completion.choices[0].message.reasoning_content)
   
   # Gunakan bidang content untuk mencetak jawaban akhir.
   print("Jawaban akhir:")
   print(completion.choices[0].message.content)

4. Output:

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