Atualizado em agosto de 2026 · Guia de Integração de API

Guia da Qwen API: Integração com Python & Node.js Fora da China

O Qwen3.8 da Alibaba rivaliza com o GPT-5.6 Sol no Artificial Analysis Intelligence Index e suporta até 1 milhão de tokens de contexto. Este guia mostra como acessar a Qwen API globalmente através do endpoint compatível com OpenAI da ChinaModelAPI — com exemplos práticos de código em Python e Node.js.

from openai import OpenAI
client = OpenAI(api_key="YOUR_KEY", base_url="https://api.chinamodelapi.com/v1")
print(client.chat.completions.create(
    model="qwen-plus",
    messages=[{"role":"user","content":"ping"}],
).choices[0].message.content)

O que é a Qwen API?

A Qwen API é a interface para desenvolvedores da Alibaba Cloud para a sua série de modelos de linguagem grande Qwen (通义千问). A API segue o formato de chat completions da OpenAI, tornando-a uma substituição direta para desenvolvedores que já utilizam modelos GPT.

Principais informações sobre a Qwen API:

  • Compatível com OpenAI — mesmo formato de requisição/resposta do GPT
  • Janela de contexto do Qwen-Max — até 1.000.000 de tokens
  • Idiomas — multilíngue (100+), excelente em chinês-inglês
  • AA Intelligence Index — topo do ranking open-weight, competitivo com o GPT-5.6 Sol
  • Suporta — chat, function calling, streaming, visão (Qwen-VL)

Modelos Qwen: Qual Usar?

ID do Modelo Melhor para Contexto Velocidade Custo
qwen-3 Tarefas gerais, desempenho mais recente 128K Rápido $$
qwen-max Documentos longos, raciocínio complexo 1M Moderado $$$
qwen-plus Equilibrado: velocidade + qualidade 128K Rápido $$
qwen-2.5 Cargas de trabalho estáveis em produção 128K Rápido $
qwen-2.5-coder Geração & completamento de código 128K Rápido $

Como Acessar a Qwen API Fora da China: 4 Passos

  1. 1
    Create a ChinaModelAPI account

    Cadastre-se em chinamodelapi.com — sem necessidade de cartão de crédito.

  2. 2
    Purchase tokens with USDT

    O plano Starter ($9.9) é suficiente para testes. Os tokens nunca expiram.

  3. 3
    Copy your API key

    Sua chave do painel funciona em todos os modelos Qwen.

  4. 4
    Change base_url in your SDK

    Uma linha de código — veja os exemplos abaixo.

Integração em Python: Qwen API

Instale o OpenAI Python SDK: pip install openai

qwen_basic.py
from openai import OpenAI

client = OpenAI(
    base_url="https://api.chinamodelapi.com/v1",
    api_key="your-chinamodelapi-key"
)

response = client.chat.completions.create(
    model="qwen-3",  # or qwen-max, qwen-plus, qwen-2.5
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain transformer architecture in 3 sentences."}
    ],
    max_tokens=1024
)

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

Para respostas em streaming:

qwen_streaming.py
stream = client.chat.completions.create(
    model="qwen-max",
    messages=[{"role": "user", "content": "Write a Python function for binary search."}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Integração em Node.js: Qwen API

Instalação: npm install openai

qwen.js
import OpenAI from "openai";

const client = new OpenAI({
    baseURL: "https://api.chinamodelapi.com/v1",
    apiKey: "your-chinamodelapi-key"
});

const response = await client.chat.completions.create({
    model: "qwen-3",  // or "qwen-max", "qwen-plus"
    messages: [
        { role: "user", content: "Translate this to Chinese: Hello, world!" }
    ]
});

console.log(response.choices[0].message.content);

Perguntas Frequentes

Posso usar a Qwen API gratuitamente?

A ChinaModelAPI não oferece um plano gratuito, mas o plano Starter a $9.9 fornece tokens substanciais para testes e pequenos projetos. Os tokens nunca expiram, portanto não há pressão de tempo para utilizá-los.

A Qwen API suporta function calling?

Sim. O Qwen3.8 e o Qwen-Max suportam function calling compatível com OpenAI (tool use). O formato da requisição é idêntico ao da OpenAI — defina suas ferramentas no parâmetro tools e o modelo retornará chamadas de função estruturadas.

Qual é a janela de contexto do Qwen-Max?

O Qwen-Max suporta até 1.000.000 de tokens de contexto — o equivalente a aproximadamente 750.000 palavras ou um livro inteiro. Esta é uma das maiores janelas de contexto disponíveis, tornando-o ideal para analisar documentos longos, bases de código ou artigos científicos.

Existe limite de taxa na Qwen API?

Os limites de taxa dependem do nível do seu plano. O Starter possui limites básicos adequados para desenvolvimento. O Pro e superiores oferecem maior taxa de transferência. Os planos Enterprise incluem limites de taxa personalizados e garantias de SLA. Entre em contato conosco para obter números específicos.

Guias Relacionados

Pronto para usar a Qwen API? Obtenha acesso em menos de 5 minutos.

Obter Acesso Antecipado