Aggiornato ad agosto 2026 · Guida all'integrazione API

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. 1
    Create a ChinaModelAPI account

    Registrati su chinamodelapi.com — nessuna carta di credito richiesta.

  2. 2
    Purchase tokens with USDT

    Il piano Starter ($9.9) è sufficiente per i test. I token non scadono mai.

  3. 3
    Copy your API key

    La tua chiave ottenuta dalla dashboard funziona con tutti i modelli Qwen.

  4. 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

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)

Per risposte in 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)

Integrazione Node.js: API Qwen

Installazione: 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);

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