Installez PyCharm sur Windows, créez un projet Python et effectuez votre premier appel d'API Alibaba Cloud.
Avant de commencer
Un ordinateur sous Windows.
Python installé sur votre système.
Une paire AccessKey associée à un utilisateur RAM. N'utilisez pas la paire AccessKey de votre compte Alibaba Cloud.
Installer PyCharm et créer un projet
Étape 1 : Installer PyCharm
Accédez à la page de téléchargement officielle de PyCharm.
Repérez l'édition Community Edition et cliquez sur Download.
-
Exécutez le programme d'installation téléchargé et suivez les instructions de l'assistant de configuration.
ImportantLors de l'étape Installation Options, cochez l'option Add "bin" folder to the PATH afin d'activer l'accès à PyCharm depuis la ligne de commande.
Étape 2 : Créer un nouveau projet
Ouvrez PyCharm et cliquez sur New Project.
-
Dans la boîte de dialogue New Project, configurez votre projet :
Name : saisissez un nom pour votre projet, par exemple
my-first-app.Location : répertoire destiné aux fichiers de votre projet.
-
Interpreter type : environnement d'exécution de votre projet.
-
Project venv (recommandé) : crée un environnement virtuel isolé (
venv) pour votre projet, ce qui évite les conflits de dépendances entre projets.Python version : utilise par défaut la version de Python installée sur votre système. Sélectionnez une autre version si plusieurs sont présentes.
Dans la boîte de dialogue New Project, effectuez la configuration suivante :
Name : saisissez un nom de projet, par exemple
my-first-app.Location : sélectionnez le répertoire de stockage du projet, par exemple
D:\ide\PythonProjects.Create a welcome script : activez cette option si nécessaire.
Une fois la configuration terminée, cliquez sur Create en bas à droite pour créer le projet.
Base conda : utilise le gestionnaire de packages Conda. Adapté aux projets de science des données, de calcul scientifique et multilingues présentant des dépendances complexes.
-
Custom environment : configure manuellement l'environnement.
Environment : crée un nouvel environnement ou utilise un environnement existant.
Type : outil de gestion de l'environnement.
Virtualenvest sélectionné par défaut.Base python : version de l'interpréteur Python pour l'environnement.
-
Location : répertoire de l'environnement.
Inherit packages from base interpreter : inclut les packages de l'interpréteur de base.
-
Make available to all projects : rend cet environnement accessible aux autres projets.
Dans la boîte de dialogue New Project, sélectionnez le type de projet Pure Python à gauche, définissez Name (par exemple,
my-first-app) et Location (répertoire d'enregistrement du projet) à droite, puis cliquez sur Create.
-
Cliquez sur Create.
Étape 3 : Créer et exécuter un fichier Python
Dans la fenêtre Project située à gauche, cliquez avec le bouton droit sur le dossier de votre projet (tel que
my-first-app), puis choisissez New > Python File.Dans la boîte de dialogue, saisissez un nom pour votre fichier, par exemple
hello_alibabacloud, puis appuyez sur Entrée.-
Dans la fenêtre d'édition du fichier
hello_alibabacloud.py, saisissez le code suivant :print("Hello, Alibaba Cloud!") Pour exécuter le script, cliquez sur l'icône verte Run située dans le coin supérieur droit de l'éditeur. La sortie
Hello, Alibaba Cloud!s'affiche dans la fenêtre d'outil Run en bas de l'écran.
Utiliser le terminal intégré
Le terminal intégré de PyCharm utilise automatiquement l'environnement virtuel de votre projet. Cliquez sur l'onglet Terminal ou appuyez sur Alt+F12 pour l'ouvrir. Utilisez-le pour exécuter des scripts (python hello_alibabacloud.py) ou installer des packages avec pip (pip install requests).
Contenu du fichier hello_alibabacloud.py :
print("Hello, Alibaba Cloud!")
Dans le terminal, exécutez le script avec la commande python et installez des packages tiers avec pip install :
(.venv) PS D:\ide\PythonProjects\my-first-app> python hello_alibabacloud.py
Hello, Alibaba Cloud!
(.venv) PS D:\ide\PythonProjects\my-first-app> pip install requests
Collecting requests
Obtaining dependency information for requests from https://files.pythonhosted.org/packages/70/8e/0e2d847013cb52cd35b38c009bb167a1a26b2ce6cd6965bf26b47bc0bf44/requests-2.31.0-py3-none-any.whl.metadata
Downloading requests-2.31.0-py3-none-any.whl.metadata (4.6 kB)
Collecting charset-normalizer<4,>=2 (from requests)
Obtaining dependency information for charset-normalizer<4,>=2 from https://files.pythonhosted.org/packages/b6/7c/8debebb4f90174074b827c63242c23851bdf00a53249fba57fef3416e40/charset_normalizer-3.3.2-cp312-cp312-win_amd64.whl.metadata
...ding charset_normalizer-3.3.2-cp312-cp312-win_amd64.whl.metadata (34 kB)
Collecting idna<4,>=2.5 (from requests)
Obtaining dependency information for idna<4,>=2.5 from https://files.pythonhosted.org/packages/e5/3e/741d8c82801c347547f8a2a06a57dbb01992be9e948df2ea0eda2c8b79e8/idna-3.7-py3-none-any.whl.metadata
Downloading idna-3.7-py3-none-any.whl.metadata (9.9 kB)
Étapes suivantes
Commencez à développer des applications qui interagissent avec les services Alibaba Cloud.
Exemple 1 : Appeler une API de service avec le SDK Alibaba Cloud
Utilisez le SDK Alibaba Cloud pour Python afin d'appeler l'opération ECS DescribeInstanceTypeFamilies.
Configurer l'authentification
Les appels d'API nécessitent une paire AccessKey associée à un utilisateur RAM. Pour plus d'informations, consultez la rubrique Créer une AccessKey.
Stockez toujours les identifiants dans des variables d'environnement, jamais directement dans le code. Pour obtenir des instructions, consultez la rubrique Configurer des variables d'environnement sous Linux, macOS et Windows.
Générer et exécuter l'exemple de code SDK
Accédez au SDK Center.
Sélectionnez le service (par exemple ECS) et l'opération d'API (par exemple DescribeInstanceTypeFamilies).
Dans l'onglet Parameters, renseignez les paramètres requis. Pour cet exemple, définissez
RegionIdsurcn-qingdaoetGenerationsurecs-5.-
Dans la colonne la plus à droite, cliquez sur l'onglet SDK Sample Code, sélectionnez Python, puis cliquez sur Download Project.
Dans la zone d'exemple de SDK à droite, définissez la génération du SDK sur V2.0 Recommended et la langue sur Python.
Décompressez le package téléchargé et ouvrez le projet dans PyCharm.
-
Après l'exécution du code, une valeur
statusCodede 200 dans la réponse indique que l'appel d'API a réussi, et le corps de la réponse contient la liste des familles de types d'instance ECS. Voici un extrait de la réponse :: '1rHpYSAeV5ewkgoDCes4x8A7'}, 'statusCode': 200, 'body': {'InstanceTypeFamilies': {'InstanceTypeFamily': [{'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.g6'}, {'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.ebmg
Pour plus d'informations, consultez la rubrique Utiliser le SDK Python Alibaba Cloud dans un IDE.
Exemple 2 : Appeler un grand modèle de langage (Qwen)
Appelez le grand modèle de langage (LLM) Qwen via l'API compatible OpenAI depuis Alibaba Cloud Model Studio.
Configurer l'authentification
Activez Model Studio et obtenez une clé API. Pour plus d'informations, consultez la rubrique Configuration du compte.
Configurez votre clé API en tant que variable d'environnement nommée DASHSCOPE_API_KEY. Pour obtenir des instructions, consultez la rubrique Définir votre clé API comme variable d'environnement.
Installer le SDK et exécuter l'exemple de code
-
Dans le terminal PyCharm, installez le SDK Python OpenAI :
pip install -U openaiDownloading jiter-0.8.2-cp312-cp312-win_amd64.whl (204 kB) 204.7/204.7 kB 654.9 kB/s eta 0:00:00 Downloading pydantic-2.10.6-py3-none-any.whl (431 kB) 431.7/431.7 kB 642.5 kB/s eta 0:00:00 Downloading pydantic_core-2.27.2-cp312-cp312-win_amd64.whl (2.0 MB) 2.0/2.0 MB 715.4 kB/s eta 0:00:00 Downloading sniffio-1.3.1-py3-none-any.whl (10 kB) Downloading tqdm-4.67.1-py3-none-any.whl (78 kB) 78.5/78.5 kB 875.6 kB/s eta 0:00:00 Downloading typing_extensions-4.12.2-py3-none-any.whl (37 kB) Downloading annotated_types-0.7.0-py3-none-any.whl (13 kB) Downloading h11-0.14.0-py3-none-any.whl (58 kB) 58.3/58.3 kB 762.2 kB/s eta 0:00:00 Installing collected packages: typing-extensions, tqdm, sniffio, jiter, h11, distro, annotated-types, pydantic-core, httpcore, anyio, pydantic, httpx, openai Successfully installed annotated-types-0.7.0 anyio-4.8.0 distro-1.9.0 h11-0.14.0 httpcore-1.0.7 httpx-0.28.1 jiter-0.8.2 openai-1.65.2 pydantic-2.10.6 pydantic-core-2.27.2 sniffio-1.3.1 tqdm-4.67.1 typing-extensions-4.12.2Le message
Successfully installed ... openai-x.x.xconfirme l'installation. -
Créez un nouveau fichier Python et ajoutez le code suivant :
import os from openai import OpenAI try: client = OpenAI( # Reads the API key from the DASHSCOPE_API_KEY environment variable. 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"An error occurred: {e}") -
Exécutez le script. Vous devriez voir une réponse du modèle Qwen.
D:\official_site\Demo\venv\Scripts\python.exe D:\official_site\Demo\venv\ecsram\TongYi.py I am a large language model from Alibaba Cloud. My name is Qwen.
Pour plus d'informations, consultez la rubrique SDK Python OpenAI.