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
Create a ChinaModelAPI account
Cadastre-se em chinamodelapi.com — sem necessidade de cartão de crédito.
-
2
Purchase tokens with USDT
O plano Starter ($9.9) é suficiente para testes. Os tokens nunca expiram.
-
3
Copy your API key
Sua chave do painel funciona em todos os modelos Qwen.
-
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
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:
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
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