API Qwen: prima richiesta in cinque minuti

URL base e autenticazione

La nostra API segue il formato standard OpenAI, rendendo facile cambiare la configurazione del tuo client esistente. L'URL base per tutte le richieste è https://api.qwenapis.com/v1. Avrai bisogno di una chiave API per autenticare le tue richieste. Se non l'hai ancora creata, visita la pagina Ottieni chiave API per generare una chiave usando solo email e password. Non è richiesta la carta di credito per iniziare con il credito di prova.

Ogni account è limitato a una chiave attiva alla volta. Puoi rigenerare la tua chiave in qualsiasi momento, il che revoca immediatamente quella precedente. Questo garantisce che se la tua chiave viene esposta, puoi proteggere il tuo account istantaneamente senza aspettare un ciclo mensile. Tieni la tua chiave sicura nelle variabili di ambiente o nel gestore di segreti.

Esegui la tua prima richiesta

Verifica la tua configurazione inviando una semplice richiesta di completamento del testo. L'esempio seguente usa curl per inviare un prompt al modello senza censura. Sostituisci YOUR_API_KEY con la chiave generata nel passaggio precedente. L'ID del modello è impostato su uncensored, che è ottimizzato per rispondere senza rifiuti sui contenuti per uso adulto lecito.

Copycurl https://api.qwenapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Se ha successo, riceverai una risposta JSON contenente il testo generato. Se ricevi un errore 401, controlla che la tua chiave sia corretta. Un errore 402 indica che il tuo credito prepagato è stato esaurito.

Integrazione SDK Python

Per gli sviluppatori Python, l'SDK ufficiale OpenAI funziona direttamente con il nostro endpoint. Installa la libreria usando pip, quindi configura il client per puntare al nostro URL base. Questo ti permette di utilizzare metodi familiari come chat.completions.create() senza modificare significativamente la logica della tua applicazione. L'SDK gestisce la serializzazione JSON e la logica di retry per te.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.qwenapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Ricorda di impostare correttamente api_key e base_url. Il nome del modello rimane uncensored. Questo approccio garantisce la compatibilità con il codice scritto per altri provider, rendendo facile cambiare o testare endpoint diversi.

Utilizzo SDK Node

Gli sviluppatori Node.js possono utilizzare il pacchetto npm @anthropic-ai/sdk o l'ufficiale openai. Configura il client con il nostro URL base e la tua chiave API. La struttura della richiesta è identica ad altri servizi compatibili con OpenAI. Questo ti permette di integrare Qwen senza censura nelle tue applicazioni Node.js esistenti con modifiche minime al codice.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Assicurati di gestire appropriatamente la risposta asincrona. L'SDK restituirà l'oggetto di completamento completo, incluse le statistiche di utilizzo dei token. Questo ti aiuta a monitorare il consumo del tuo credito prepagato in tempo reale.

Abilita lo streaming

Per una latenza inferiore e una migliore esperienza utente, abilita lo streaming nelle tue richieste. Lo streaming invia la risposta token per token mentre viene generata, permettendo alla tua applicazione di visualizzare l'output in modo progressivo. Imposta il parametro stream su true nella tua richiesta. L'SDK fornirà uno stream iterabile di chunk.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Questo è particolarmente utile per la generazione di contenuti lunghi o applicazioni interattive. Ogni chunk contiene testo parziale, che puoi aggiungere al tuo buffer di visualizzazione. Lo stream termina quando il modello completa la risposta o raggiunge il limite di contesto.

Limiti, errori e contesto

La nostra API ha limiti specifici per garantire un utilizzo equo. Ti sono consentite 300 richieste al minuto per chiave. La dimensione massima del corpo della richiesta è 8 MB. La finestra di contesto è di 100.000 token, che coprono sia il prompt che il completamento. Se superi il limite di richieste, riceverai un errore 429. Se il tuo credito è insufficiente, riceverai un errore 402. Per chiavi non valide, riceverai un errore 401. Questi errori ti aiutano a gestire il flusso della tua applicazione e l'utilizzo del credito in modo efficace.