Guida all'API Qwen: integrazione Python & Node.js al di fuori della Cina
Qwen3.8 di Alibaba rivaleggia con GPT-5.6 Sol sull'Artificial Analysis Intelligence Index e supporta fino a 1 milione di token di contesto. Questa guida mostra come accedere all'API Qwen a livello globale tramite l'endpoint compatibile con OpenAI di ChinaModelAPI — con esempi di codice funzionanti per 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)
Che cos'è l'API Qwen?
L'API Qwen è l'interfaccia per sviluppatori di Alibaba Cloud per la serie di modelli linguistici di grandi dimensioni Qwen (通义千问). L'API segue il formato chat completions di OpenAI, rendendola una soluzione drop-in per gli sviluppatori che utilizzano già i modelli GPT.
Caratteristiche principali dell'API Qwen:
- • Compatibile con OpenAI — stesso formato di richiesta/risposta di GPT
- • Finestra di contesto di Qwen-Max — fino a 1.000.000 di token
- • Lingue — multilingue (100+), eccelle nella combinazione cinese-inglese
- • AA Intelligence Index — livello top per modelli open-weight, competitivo con GPT-5.6 Sol
- • Supporta — chat, function calling, streaming, vision (Qwen-VL)
Modelli Qwen: quale utilizzare?
| ID modello | Ideale per | Contesto | Velocità | Costo |
|---|---|---|---|---|
| qwen-3 | Attività generali, prestazioni all'avanguardia | 128K | Veloce | $$ |
| qwen-max | Documenti lunghi, ragionamento complesso | 1M | Moderata | $$$ |
| qwen-plus | Bilanciato: velocità + qualità | 128K | Veloce | $$ |
| qwen-2.5 | Carichi di lavoro stabili in produzione | 128K | Veloce | $ |
| qwen-2.5-coder | Generazione & completamento codice | 128K | Veloce | $ |
Come accedere all'API Qwen fuori dalla Cina: 4 passaggi
-
1
Create a ChinaModelAPI account
Registrati su chinamodelapi.com — nessuna carta di credito richiesta.
-
2
Purchase tokens with USDT
Il piano Starter ($9.9) è sufficiente per i test. I token non scadono mai.
-
3
Copy your API key
La tua chiave ottenuta dalla dashboard funziona con tutti i modelli Qwen.
-
4
Change base_url in your SDK
Una sola riga di codice — vedi gli esempi di seguito.
Integrazione Python: API Qwen
Installa l'SDK Python di OpenAI: 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)
Per risposte in 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)
Integrazione Node.js: API Qwen
Installazione: 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);
Domande frequenti
Posso usare l'API Qwen gratuitamente?
ChinaModelAPI non offre un piano gratuito, ma il piano Starter a $9.9 fornisce un numero considerevole di token per test e piccoli progetti. I token non scadono mai, quindi non c'è fretta di esaurirli.
L'API Qwen supporta il function calling?
Sì. Qwen3.8 e Qwen-Max supportano il function calling (tool use) compatibile con OpenAI. Il formato della richiesta è identico a quello di OpenAI: definisci i tuoi strumenti nel parametro tools e il modello restituirà chiamate di funzione strutturate.
Qual è la finestra di contesto di Qwen-Max?
Qwen-Max supporta fino a 1.000.000 di token di contesto — equivalenti a circa 750.000 parole o a un intero libro. Si tratta di una delle finestre di contesto più ampie disponibili, ideale per analizzare documenti lunghi, codebase o paper scientifici.
Esiste un rate limit sull'API Qwen?
I rate limit dipendono dal livello del piano. Starter ha limiti di base adatti allo sviluppo. Pro e superiori offrono un throughput maggiore. I piani Enterprise includono rate limit personalizzati e garanzie SLA. Contattaci per cifre specifiche.
Guide correlate
Pronto a usare l'API Qwen? Ottieni l'accesso in meno di 5 minuti.
Ottieni l'Accesso Anticipato