Todos los productos
Search
Centro de documentos

Alibaba Cloud SDK:Set up a Python development environment on Windows with PyCharm

Última actualización: Sep 22, 2026

Instale PyCharm en Windows, cree un proyecto de Python y ejecute su primera llamada a la API de Alibaba Cloud.

Antes de empezar

  • Una computadora con Windows.

  • Python instalado en el sistema.

  • Un par de AccessKey de un usuario de RAM. No utilice el par de AccessKey de su cuenta de Alibaba Cloud.

Instalar PyCharm y crear un proyecto

Paso 1: Instalar PyCharm

  1. Vaya a la página oficial de descarga de PyCharm.

  2. Busque la Community Edition y haga clic en Download.

  3. Ejecute el instalador descargado y siga los pasos del asistente de instalación.

    Importante

    En el paso Installation Options, seleccione Add "bin" folder to the PATH para habilitar el acceso a PyCharm desde la línea de comandos.

Paso 2: Crear un nuevo proyecto

  1. Abra PyCharm y haga clic en New Project.

  2. En el cuadro de diálogo New Project, configure el proyecto:

    • Name: introduzca un nombre para el proyecto, como my-first-app.

    • Location: el directorio donde se guardarán los archivos del proyecto.

    • Interpreter type: el entorno de ejecución del proyecto.

      • Project venv (recomendado): crea un entorno virtual aislado (venv) para el proyecto y evita conflictos de dependencias entre proyectos.

        Python version: de forma predeterminada, usa la versión de Python instalada en el sistema. Seleccione otra versión si tiene varias instaladas.

        En el cuadro de diálogo New Project, complete la siguiente configuración:

        • Name: introduzca un nombre para el proyecto, por ejemplo my-first-app.

        • Location: seleccione el directorio donde se almacenará el proyecto, por ejemplo D:\ide\PythonProjects.

        • Create a welcome script: seleccione esta opción si lo necesita.

        Una vez completada la configuración, haga clic en Create en la esquina inferior derecha para crear el proyecto.

      • Base conda: utiliza el administrador de paquetes Conda. Es ideal para ciencia de datos, computación científica y proyectos multilenguaje con dependencias complejas.

      • Custom environment: permite configurar el entorno manualmente.

        • Environment: cree un entorno nuevo o utilice uno existente.

        • Type: la herramienta de entorno. El valor predeterminado es Virtualenv.

        • Base python: la versión del intérprete de Python para el entorno.

        • Location: el directorio del entorno.

          • Inherit packages from base interpreter: incluye los paquetes del intérprete base.

          • Make available to all projects: hace que este entorno esté disponible para otros proyectos.

            En el cuadro de diálogo New Project, seleccione el tipo de proyecto Pure Python en el panel izquierdo. A continuación, establezca Name (por ejemplo, my-first-app) y Location (el directorio donde se guardará el proyecto) en el panel derecho, y haga clic en Create.

  3. Haga clic en Create.

Paso 3: Crear y ejecutar un archivo de Python

  1. En la ventana de herramientas Project, ubicada a la izquierda, haga clic con el botón derecho en la carpeta del proyecto (como my-first-app) y elija New > Python File.

  2. En el cuadro de diálogo, introduzca un nombre para el archivo, como hello_alibabacloud, y presione Entrar.

  3. En la ventana del editor para hello_alibabacloud.py, escriba a continuación el código:

    print("Hello, Alibaba Cloud!")
  4. Para ejecutar el script, haga clic en el ícono verde Run en la esquina superior derecha del editor. La salida Hello, Alibaba Cloud! aparecerá en la ventana de herramientas Run en la parte inferior.

Usar la terminal integrada

La terminal integrada de PyCharm utiliza automáticamente el entorno virtual del proyecto. Haga clic en la pestaña Terminal o presione Alt+F12 para abrirla. Úsela para ejecutar scripts (python hello_alibabacloud.py) o instalar paquetes con pip (pip install requests).

Contenido de hello_alibabacloud.py:

print("Hello, Alibaba Cloud!")

En la terminal, ejecute el script con el comando python e instale paquetes de terceros con 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)

Qué hacer a continuación

Comience a desarrollar aplicaciones que interactúen con los servicios de Alibaba Cloud.

Ejemplo 1: Llamar a la API de un servicio con el SDK de Alibaba Cloud

Utilice el SDK de Alibaba Cloud para Python y llame a la operación DescribeInstanceTypeFamilies de ECS.

Configurar la autenticación

Las llamadas a la API requieren un par de AccessKey de un usuario de RAM. Para obtener más información, consulte Create an AccessKey.

Importante

Almacene siempre las credenciales en variables de entorno, nunca en el código. Para consultar las instrucciones, vea Configure environment variables on Linux, macOS, and Windows.

Generar y ejecutar el código de ejemplo del SDK

  1. Vaya al SDK Center.

  2. Seleccione el servicio (como ECS) y la operación de la API (como DescribeInstanceTypeFamilies).

  3. En la pestaña Parameters, complete los parámetros obligatorios. Para este ejemplo, establezca RegionId en cn-qingdao y Generation en ecs-5.

  4. En la columna más a la derecha, haga clic en la pestaña SDK Sample Code, seleccione Python y haga clic en Download Project.

    En el área de ejemplo del SDK, a la derecha, establezca la generación del SDK en V2.0 Recommended y el lenguaje en Python.

  5. Descomprima el paquete descargado y abra el proyecto en PyCharm.

  6. Después de ejecutar el código, un valor statusCode de 200 en la respuesta indica que la llamada a la API se completó correctamente. El cuerpo de la respuesta contiene la lista de familias de tipos de instancia de ECS. A continuación se muestra una parte de la respuesta:

    : '1rHpYSAeV5ewkgoDCes4x8A7'}, 'statusCode': 200, 'body': {'InstanceTypeFamilies': {'InstanceTypeFamily': [{'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.g6'}, {'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.ebmg

Para obtener más información, consulte Use the Alibaba Cloud Python SDK in an IDE.

Ejemplo 2: Llamar a un modelo de lenguaje extenso (Qwen)

Llame al modelo de lenguaje extenso (LLM) Qwen mediante la API compatible con OpenAI de Alibaba Cloud Model Studio.

Configurar la autenticación

Active Model Studio y obtenga una clave de API. Para obtener más información, consulte Account setup.

Importante

Configure su clave de API como una variable de entorno llamada DASHSCOPE_API_KEY. Para consultar las instrucciones, vea Set your API key as an environment variable.

Instalar el SDK y ejecutar el código de ejemplo

  1. En la terminal de PyCharm, instale el SDK de OpenAI para Python:

    pip install -U openai
    Downloading 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.2

    El mensaje Successfully installed ... openai-x.x.x confirma que la instalación se completó correctamente.

  2. Cree un nuevo archivo de Python y agregue a continuación el código:

    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}")
  3. Ejecute el script. Debería ver una respuesta del modelo 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.

Para obtener más información, consulte OpenAI Python SDK.