Todos os produtos
Search
Central de documentação

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

Última atualização: Sep 22, 2026

Instale o PyCharm no Windows, crie um projeto Python e faça sua primeira chamada de API da Alibaba Cloud.

Antes de começar

  • Um computador com Windows.

  • Python instalado no seu sistema.

  • Um par de AccessKey de um usuário do RAM. Não use o par de AccessKey da sua conta da Alibaba Cloud.

Instale o PyCharm e crie um projeto

Etapa 1: Instale o PyCharm

  1. Acesse a página oficial de download do PyCharm.

  2. Encontre a Community Edition e clique em Download.

  3. Execute o instalador baixado e siga o assistente de configuração.

    Importante

    Na etapa Installation Options, selecione Add "bin" folder to the PATH para ativar o acesso ao PyCharm pela linha de comando.

Etapa 2: Crie um novo projeto

  1. Abra o PyCharm e clique em New Project.

  2. Na caixa de diálogo New Project, configure o seu projeto:

    • Name: insira um nome para o seu projeto, como my-first-app.

    • Location: o diretório para os arquivos do seu projeto.

    • Interpreter type: o ambiente de execução do seu projeto.

      • Project venv (recomendado): cria um ambiente virtual isolado (venv) para o seu projeto, para evitar conflitos de dependências entre projetos.

        Python version: o padrão é a versão do Python no seu sistema. Selecione uma versão diferente se houver várias instaladas.

        Na caixa de diálogo New Project, conclua a configuração a seguir:

        • Name: insira um nome para o projeto, por exemplo, my-first-app.

        • Location: selecione o diretório em que o projeto será armazenado, por exemplo, D:\ide\PythonProjects.

        • Create a welcome script: selecione esta opção se necessário.

        Após concluir a configuração, clique em Create no canto inferior direito para criar o projeto.

      • Base conda: usa o gerenciador de pacotes Conda. Ideal para ciência de dados, computação científica e projetos multilíngues com dependências complexas.

      • Custom environment: configure o ambiente manualmente.

        • Environment: crie um novo ambiente ou use um existente.

        • Type: a ferramenta de ambiente. O padrão é Virtualenv.

        • Base python: a versão do interpretador Python para o ambiente.

        • Location: o diretório para o ambiente.

          • Inherit packages from base interpreter: inclui pacotes do interpretador base.

          • Make available to all projects: torna este ambiente acessível a outros projetos.

            Na caixa de diálogo New Project, selecione o tipo de projeto Pure Python à esquerda, defina Name (por exemplo, my-first-app) e Location (o diretório onde o projeto é salvo) à direita e clique em Create.

  3. Clique em Create.

  4. Etapa 3: Crie e execute um arquivo Python

    1. Na janela de ferramentas Project à esquerda, clique com o botão direito na pasta do seu projeto (como my-first-app) e escolha New > Python File.

    2. Na caixa de diálogo, insira um nome para o seu arquivo, como hello_alibabacloud, e pressione Enter.

    3. Na janela do editor para hello_alibabacloud.py, digite o seguinte código:

      print("Hello, Alibaba Cloud!")
    4. Para executar o script, clique no ícone verde Run no canto superior direito do editor. A saída Hello, Alibaba Cloud! aparece na janela de ferramentas Run na parte inferior.

    Use o terminal integrado

    O terminal integrado do PyCharm usa automaticamente o ambiente virtual do seu projeto. Clique na aba Terminal ou pressione Alt+F12 para abri-lo. Utilize-o para executar scripts (python hello_alibabacloud.py) ou instalar pacotes com o pip (pip install requests).

    Conteúdo de hello_alibabacloud.py:

    print("Hello, Alibaba Cloud!")

    No terminal, execute o script com o comando python e instale pacotes de terceiros com 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)

    Próximos passos

    Comece a criar aplicações que interajam com os services da Alibaba Cloud.

    Exemplo 1: Chamar uma API de service com o SDK da Alibaba Cloud

    Use o SDK da Alibaba Cloud para Python para chamar a operação DescribeInstanceTypeFamilies do ECS.

    Configure a autenticação

    As chamadas de API exigem um par de AccessKey de um usuário do RAM. Para mais informações, consulte Create an AccessKey.

    Importante

    Armazene sempre as credenciais em variáveis de ambiente, nunca no código. Para obter instruções, consulte Configure environment variables on Linux, macOS, and Windows.

    Gere e execute o código de exemplo do SDK

    1. Acesse o SDK Center.

    2. Selecione o service (como ECS) e a operação de API (como DescribeInstanceTypeFamilies).

    3. Na aba Parameters, preencha os parâmetros obrigatórios. Para este exemplo, defina RegionId como cn-qingdao e Generation como ecs-5.

    4. Na coluna mais à direita, clique na aba SDK Sample Code, selecione Python e clique em Download Project.

      Na área de exemplo do SDK à direita, defina a geração do SDK como V2.0 Recommended e a linguagem como Python.

    5. Descompacte o pacote baixado e abra o projeto no PyCharm.

    6. Depois de executar o código, um valor statusCode igual a 200 na resposta indica que a chamada de API foi bem-sucedida, e o corpo da resposta contém a lista de famílias de tipos de instância do ECS. A seguir, parte da resposta:

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

    Para mais informações, consulte Use the Alibaba Cloud Python SDK in an IDE.

    Exemplo 2: Chamar um modelo de linguagem grande (Qwen)

    Chame o modelo de linguagem grande (LLM) Qwen por meio da API compatível com OpenAI do Alibaba Cloud Model Studio.

    Configure a autenticação

    Ative o Model Studio e obtenha uma chave de API. Para mais informações, consulte Account setup.

    Importante

    Configure sua chave de API como uma variável de ambiente chamada DASHSCOPE_API_KEY. Para obter instruções, consulte Set your API key as an environment variable.

    Instale o SDK e execute o código de exemplo

    1. No terminal do PyCharm, instale o SDK do 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

      A mensagem Successfully installed ... openai-x.x.x confirma a instalação.

    2. Crie um novo arquivo Python e adicione o seguinte 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. Execute o script. Você verá uma resposta do 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 mais informações, consulte OpenAI Python SDK.