Chave API do Qwen Code: onde a obter, como a ligar e calcular o consumo

Alguém instala o Qwen Code, inicia-o no terminal e, logo no primeiro pedido, é-lhe pedida uma chave. Depois começa a pesquisa: as pessoas escrevem «buy api key for qwen code» e acabam em páginas onde lhes vendem uma subscrição ou um acesso já preparado de outra pessoa. Eis o que é a chave, onde a obter e quanto custa, passo a passo.

A ideia principal, desde já: ninguém vende uma chave API como um produto independente e pronto a usar. É uma cadeia de acesso que emite para si na conta do fornecedor do modelo, e a emissão é gratuita. Só precisa de dinheiro mais tarde, quando carregar o saldo; nessa etapa aplicam-se as condições do fornecedor. A seguir: onde obter uma chave, como ligá-la ao Qwen Code e quanto custa utilizá-la.

O que é exatamente uma chave API para o Qwen Code?#

O Qwen Code é um agente de IA de código aberto que funciona no terminal e escreve código para as suas tarefas. É gratuito, instala-se através do npm e não tem uma rede neuronal própria. Todo o trabalho inteligente é feito pelo modelo, que funciona nos servidores do fornecedor.

O Qwen Code precisa de uma autorização para aceder ao modelo. Essa autorização é a chave API — uma cadeia longa, semelhante a uma palavra-passe, que o fornecedor emite pessoalmente para si. Quando o agente envia um pedido, inclui a chave; o fornecedor utiliza-a para identificar de quem é o pedido, responde e desconta a utilização do seu saldo.

Daqui resulta uma ideia simples que esclarece metade da confusão. Uma chave não se compra como um produto num marketplace: cria uma conta junto de um fornecedor, clica em «criar chave» e obtém a cadeia gratuitamente. A pesquisa «buy api key» significa, na realidade, «onde posso criar uma conta e como pago depois a utilização», e as duas perguntas são respondidas a seguir.

Em que difere uma chave API de uma subscrição e do antigo acesso gratuito?#

No Qwen Code, /auth mostra as opções de autenticação suportadas pela versão instalada. Escolha a entrada da plataforma que emitiu a chave e do respetivo plano de faturação. As distinções abaixo explicam o antigo acesso gratuito, o Coding Plan e a chave API normal usada neste guia; não são uma lista exaustiva das opções atuais do menu.

A primeira opção é o acesso gratuito através de uma conta Qwen (Qwen OAuth). Antigamente, permitia aceder ao modelo sem chave, mas foi descontinuada.

A segunda opção é a subscrição Coding Plan da Alibaba ModelStudio. Tem um valor mensal fixo e dá acesso a uma quota semanal de pedidos e a um endereço de ligação separado.

A terceira opção é a chave API de um fornecedor de modelos. Não há uma taxa fixa: carrega o saldo e gasta-o à medida que trabalha, de acordo com o consumo de tokens. Esta opção é flexível e adequada se usar o agente de forma irregular. O resto deste artigo centra-se nela.

Onde pode obter uma chave API para o Qwen Code?#

Como o Qwen Code compreende diferentes protocolos, não está limitado a um único fornecedor de chaves. A documentação oficial lista explicitamente os serviços a que se pode ligar.

Segue-se a forma de ligação direta.

Para a ligação direta, abra a consola Alibaba Model Studio, selecione a região pretendida e crie uma chave na página de gestão de chaves API. Guarde a região e o nome do espaço de trabalho com a configuração; não copie a chave para notas partilhadas.

O guia regional recomenda domínios dedicados ao espaço de trabalho para produção. Copie o API Host real da gestão de espaços de trabalho e siga o guia de URL base; não invente um ID de espaço de trabalho. Os endpoints DashScope partilhados existentes e os dedicados ao espaço de trabalho são opções de acesso diferentes. O Coding Plan e o Token Plan também usam endpoints e chaves próprios. Copie o URL base completo compatível com OpenAI da consola do espaço de trabalho na região escolhida para DASHSCOPE_BASE_URL. O JSON omite baseUrl; antes de iniciar, o endereço é fornecido através de OPENAI_BASE_URL. Use valores reais da consola, não um identificador de exemplo.

Existe ainda uma opção gratuita, que não exige qualquer chave: execute um modelo Qwen no seu computador através do Ollama e ligue-lhe o Qwen Code como se fosse o seu próprio servidor. É necessário um computador potente e uma configuração separada. O guia sobre como iniciar o Qwen Code no terminal mostra como executar o agente localmente.

Como adicionar a chave ao Qwen Code para que funcione?#

Faça uma cópia das definições existentes e integre a ligação abaixo em ~/.qwen/settings.json; não substitua outros fornecedores ou preferências. Esta configuração ilustrativa segue o exemplo de autenticação do Qwen Code com o URL do espaço de trabalho através de OPENAI_BASE_URL, a chave API lida da variável de ambiente indicada por envKey e sem o bloco env com o segredo em texto simples. qwen3-coder-plus é o modelo desse exemplo oficial; confirme primeiro que a sua região e conta o disponibilizam, ou use um ID real da consola dessa região nos dois locais.

Copie o URL base completo compatível com OpenAI da consola do espaço de trabalho na região escolhida para DASHSCOPE_BASE_URL. O JSON omite baseUrl; antes de iniciar, o endereço é fornecido através de OPENAI_BASE_URL. Use valores reais da consola, não um identificador de exemplo.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

openai seleciona o protocolo compatível. envKey identifica a variável que o Qwen Code lê; não é o valor da chave. model.name tem de corresponder ao id configurado. A referência dos fornecedores de modelos documenta estes campos.

No macOS ou Linux, abra um terminal Bash, introduza a chave num pedido oculto e inicie o Qwen Code nesse mesmo terminal:

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

No Windows, use o PowerShell:

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

Estes comandos mantêm o segredo literal fora do JSON e do histórico de comandos; o processo em execução continua a recebê-lo no seu ambiente. Não o apresente, não o inclua em commits nem o cole num prompt. Ao adotar este percurso, remova das definições qualquer entrada env antiga que contenha o segredo. Num novo terminal, é necessário fornecer novamente a variável.

No Qwen Code, use /doctor para inspecionar a autenticação e /model para verificar a opção configurada. Numa pasta de teste vazia e inofensiva, envie: «Responde com a palavra connected. Não leias nem alteres ficheiros e não executes comandos.» Uma resposta bem-sucedida testa um pedido ao modelo e pode gerar custos de utilização. Ver o modelo em /model confirma apenas a configuração local.

Se o pedido falhar, registe o erro sem segredos e o ID do pedido, quando fornecido. Verifique a autenticação separadamente da disponibilidade do modelo e da faturação: confirme a plataforma que emitiu a chave, a região e o espaço de trabalho, o endpoint normal ou de plano, o ID do modelo selecionado e o saldo ou a quota na mesma consola do fornecedor. Um 401 pode refletir uma incompatibilidade entre chave, endpoint ou plano de faturação; não prova que o fornecedor esteja avariado. Pare após a verificação falhada e corrija a incompatibilidade documentada antes de voltar a tentar. Este artigo descreve um exemplo baseado na documentação, não um pedido pago executado para este guia.

Quanto custa trabalhar com uma chave API e o que faz a fatura aumentar?#

Uma chave difere de uma subscrição porque não tem um valor mensal fixo. Paga pelo que o modelo lê e escreve, medido em tokens. Um token é um fragmento de texto com cerca de algumas letras. Cada modelo tem o seu próprio preço por milhão de tokens de entrada e por milhão de tokens de saída, sendo que a saída custa quase sempre mais do que a entrada.

Um milhão de tokens parece muito, mas, ao trabalhar num projeto de grandes dimensões, desaparece mais depressa do que se espera: o agente lê os seus ficheiros integralmente em cada pedido.

Eis a conclusão prática. A fatura depende da quantidade de texto processada pelo agente. Ficheiros longos, sessões prolongadas e a leitura repetida do código consomem o saldo mais depressa; o número de tarefas é secundário. Um artigo separado explica, passo a passo, como é calculado o consumo de tokens da API e porque pode esgotar-se sem se dar por isso.

Porque são os pagamentos recusados?#

É aqui que ocorre um erro comum.

O obstáculo surge um passo mais tarde. Já emitiu a chave, mas sem dinheiro no saldo ela não vai consumir nada — o fornecedor devolve um erro de fundos insuficientes.

Se a recusa estiver relacionada com o banco que emitiu o cartão, alterar o e-mail, o idioma da interface ou as definições do perfil não muda as condições de pagamento. Este mecanismo é explicado através do exemplo de um cartão estrangeiro para o Claude.

E tenha em conta que a decisão final cabe ao gateway de pagamento. Este pode recusar o pagamento pelos seus próprios motivos, e não há garantias de que seja aceite.

Por onde começar?#

Um breve plano passo a passo:

1. Distinga os percursos descritos e o plano da sua chave; não presuma que o menu atual tem apenas três opções. O antigo nível gratuito Qwen terminou em abril de 2026, o Coding Plan usa subscrição e este guia segue a chave API normal paga por utilização.
2. Crie uma conta junto de um fornecedor. A opção mais simples é a própria Alibaba.
3. Emita uma chave na conta do fornecedor, na secção de chaves de acesso. A emissão é gratuita; não precisa de um cartão para isso.
4. Integre a ligação regional em ~/.qwen/settings.json sem o valor secreto. Forneça DASHSCOPE_API_KEY no terminal de arranque e, em seguida, verifique o modelo selecionado e uma resposta curta, como mostrado acima.
5. Para pagar a utilização, precisa de um cartão emitido em seu nome e aceite pelo gateway de pagamento do fornecedor. O gateway de pagamento determina as condições de carregamento; emitir uma chave e pagar pela utilização são etapas separadas.

Também vale a pena ponderar de que modelo precisa. Para tarefas exigentes, escolha o Qwen3-Coder-Plus, de gama superior; para poupar dinheiro, escolha o Flash, mais leve e várias vezes mais barato para o mesmo volume. O guia sobre o Qwen Code como alternativa ao Claude Code mostra as diferenças entre o Qwen Code e outros agentes de terminal.

Encontra mais materiais na Ailoot.