Sua primeira chamada de API

Este exemplo apresenta uma integração de texto pelo formato compatível com a API da OpenAI. A requisição é enviada à infraestrutura da QwenCloud, com um modelo da Qwen.

1. Prepare sua conta e sua chave

Acesse a QwenCloud, confira os requisitos de uso e obtenha uma chave de API. A disponibilidade de cotas, modelos e modalidades depende das condições da sua conta.

Veja como preparar sua chave de API →

2. Instale o SDK

pip install openai

3. Configure uma variável de ambiente

No terminal do ambiente em que sua aplicação será executada, configure a chave. Substitua o valor de exemplo pela sua credencial e mantenha-a fora do código-fonte.

export DASHSCOPE_API_KEY="SUA_CHAVE_DE_API"

4. Envie uma mensagem

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://maas.qwencloudapi.com/compatible-mode/v1",
)

response = client.chat.completions.create(
    model="qwen3.8-flash",
    messages=[
        {"role": "user", "content": "Explique o que é uma API em uma frase."}
    ],
)

print(response.choices[0].message.content)

Confira os detalhes da sua integração

O modelo do exemplo consta no catálogo coletado em outubro de 2026. Antes de executar, confirme o identificador, a região, a disponibilidade e os parâmetros atuais na referência original.

Essa chamada pode gerar cobrança conforme as condições da sua conta. O portal Qwen Brasil não executa a requisição e não recebe sua chave de API.

Consultar referências de preço →