IT ▾
Ottieni la chiave API

uncensoredqwen.comGuida

Chiave API Qwen per VS Code: configurazione endpoint personalizzato

Per usare una chiave API Qwen per VS Code non serve un plugin specifico di Alibaba. Qualsiasi estensione che supporta un provider compatibile con OpenAI accetta tre valori: un URL base, una chiave e un nome del modello. Questa guida fornisce i valori esatti e i controlli per evitare gli errori più comuni.

Aggiornato

Pannello editor di codice isometrico con una chiave dorata inserita in una presa di endpoint collegata a un server

Cosa ti serve prima di aprire VS Code

Una chiave API Qwen per VS Code è solo una chiave API più le impostazioni dell'endpoint giuste in un'estensione. Raccogli prima questi tre valori:

  • URL base: https://api.uncensoredqwen.com/v1
  • ID modello: uncensored
  • Chiave API: creata nella pagina delle chiavi API dopo esserti registrato con Google o con email e password

I nuovi account possono richiedere $0,50 di credito di prova con un clic su quella pagina. Non serve la carta, è limitato a uno per persona e resta valido per 7 giorni. È sufficiente per testare la configurazione dell'editor per alcuni giorni di coding reale.

Una nota sulla denominazione: il servizio è un modello a pesi aperti ospitato da un provider indipendente. Non è l'API ufficiale di Alibaba e non è un router verso altri fornitori. Nel tuo editor apparirà con il nome visualizzato che gli assegni.

Testa la chiave con curl prima

Prima di modificare qualsiasi impostazione dell'editor, conferma che la chiave e l'URL funzionino da soli. Se questo fallisce, nessuna estensione avrà successo e saprai che il problema è la chiave e non il plugin.

export API_KEY="paste-your-key-here"

curl https://api.uncensoredqwen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Una lista JSON che include uncensored significa che l'autenticazione funziona. Poi invia una vera chiamata di completamento:

curl https://api.uncensoredqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'

Le intestazioni di risposta includono X-Balance-USD, un modo rapido per vedere il credito rimanente senza lasciare il terminale.

Aggiungi il provider in un'estensione VS Code

Diverse estensioni VS Code per l'assistenza alla programmazione con AI possono comunicare con qualsiasi server compatibile con OpenAI. Le etichette variano leggermente da strumento a strumento, ma i campi mappano uno a uno. Cerca una scelta del provider denominata "OpenAI Compatible", "OpenAI" con un URL base personalizzato o "Custom endpoint".

Campo estensioneValore da inserire
ProviderCompatibile con OpenAI (o OpenAI con URL base personalizzato)
URL base / API basehttps://api.uncensoredqwen.com/v1
Chiave APILa chiave dal tuo account
ID modellouncensored

Le estensioni che leggono un file di configurazione JSON di solito vogliono qualcosa di simile a questo. I nomi esatti dei campi variano, quindi controlla la documentazione della tua estensione e adatta i nomi dei campi:

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.uncensoredqwen.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

Non salvare questo file. Se le tue impostazioni si trovano all'interno di un repository, usa l'archivio segreto dell'estensione o una variabile d'ambiente, e aggiungi il percorso di configurazione a .gitignore.

Dopo il salvataggio, apri il pannello chat dell'estensione e invia un messaggio breve come "Spiega questa funzione" con un file aperto. Una risposta in streaming significa che la configurazione è completa.

Correggi gli errori di configurazione comuni

La maggior parte delle configurazioni fallite dipende da un piccolo numero di refusi. Procedi in ordine con questo elenco.

L'URL ha la forma sbagliata

L'URL base termina con /v1. Le estensioni aggiungono /chat/completions da sole. Se incolli il percorso completo, ottieni un 404 perché il client richiede /v1/chat/completions/chat/completions. Una barra finale di solito è innocua, ma la mancanza di /v1 non lo è.

Il nome del modello è sbagliato

Alcune estensioni precompilano un menu a discesa del modello con nomi di un altro servizio. Sovrascrivilo con uncensored esattamente, in minuscolo. Se il campo è un menu a discesa senza voce personalizzata, cerca un'opzione "custom model" o "other".

La chiave ha caratteri estranei

La copia da una pagina web può aggiungere uno spazio finale o un ritorno a capo. Incolla in un editor di testo semplice, rimuovi gli spazi e incolla di nuovo. Una risposta 401 indica quasi sempre questo problema o una chiave appartenente a un account diverso.

L'estensione parla ancora al suo server predefinito

Se il tuo saldo non cambia dopo le richieste di chat, l'editor potrebbe usare un provider integrato. Verifica che il profilo del modello attivo sia quello che hai modificato e ricarica la finestra dopo aver cambiato le impostazioni.

Le richieste falliscono con 429

Questo è un limite di richieste, trattato nella sezione successiva. Il corpo dell'errore contiene un codice che indica quale limite hai raggiunto.

Verifica che le richieste raggiungano davvero l'API

Gli editor raramente ti dicono quale server ha risposto. Due controlli rapidi eliminano ogni dubbio.

  1. Monitora il saldo. Esegui la chiamata /v1/models o una breve chiamata di completamento dal terminale, annota l'intestazione X-Balance-USD, invia tre messaggi di chat nell'editor, poi ripeti la chiamata dal terminale. Il numero dovrebbe diminuire di una piccola quantità. Lo stesso valore è disponibile da GET /v1/balance.
  2. Chiedi qualcosa che la configurazione predefinata rifiuterebbe o gestirebbe diversamente. Un test piccolo e innocuo è richiedere una risposta di esattamente cinque parole. Se la risposta segue l'istruzione e arriva in streaming, la connessione è sana.

Se il saldo non si muove, apri il pannello output dell'estensione o la console degli sviluppatori. La maggior parte delle estensioni registra l'URL della richiesta e lo stato HTTP, e un host errato appare immediatamente. Correggi l'URL base, ricarica la finestra e riprova.

I team che condividono un repository dovrebbero dare a ciascuno una chiave separata invece di un valore condiviso. In questo modo un limite di richieste raggiunto da una persona non blocca gli altri e una chiave rubata può essere sostituita senza disturbare tutti gli altri.

Autocompletamento, chat e limiti di richieste

La chat è gentile con i limiti: una richiesta per messaggio. L'autocompletamento inline è diverso. Molte estensioni inviano una richiesta dopo una breve pausa nella digitazione, il che può produrre dozzine di chiamate al minuto mentre lavori.

Conosci i numeri. Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto. Una chiave di prova permette 2 concorrenti e 60 al minuto. Quando li superi, l'API risponde con HTTP 429 e il codice rate_limited (troppe al minuto) o concurrency (troppe contemporaneamente). In caso di sovraccarico temporaneo ricevi anche 429 con un'intestazione Retry-After: 5. Un completamento in streaming mantiene la sua slot di concorrenza fino alla fine dello stream, quindi gli stream lenti contano contro di te più a lungo.

Impostazioni pratiche che aiutano:

  • Usa il servizio per chat, modifiche e spiegazioni e disattiva l'autocompletamento con tab o aumenta il suo ritardo di debounce mentre sei su una chiave di prova.
  • Abbassa il numero massimo di token di output per l'autocompletamento a qualche decina. I completamenti brevi terminano rapidamente e liberano la slot.
  • Evita di aprire più finestre dell'editor con la stessa chiave durante la prova.

Le richieste fallite o rifiutate non vengono addebitate, quindi gli errori non costano nulla se non tempo.

Costo di una sessione di codifica

I prompt di codifica sono pesanti in input perché le estensioni allegano i contenuti dei file. Il prezzo è $0,15 per 1M di token di input e $0,50 per 1M di token di output. Considera un turno di chat che invia 6.000 token di codice e contesto e riceve 800 token indietro:

  • Input: 6.000 x $0,15 / 1.000.000 = $0,0009
  • Output: 800 x $0,50 / 1.000.000 = $0,0004
  • Totale: $0,0013 per turno

A 100 turni di questo tipo in una giornata lavorativa il costo è $0,13. Il credito di prova da $0,50 copre circa 380 turni di questa dimensione ($0,50 / $0,0013 fa circa 385). Il credito è prepagato, non scade mai e i ricarichi sono importi interi da $20 a $500, con un bonus del 5% da $50, del 10% da $100 e del 15% da $200. Vedi la pagina dei prezzi per i metodi di pagamento.

La finestra di contesto è di 100.000 token, prompt più completamento. Se un'estensione indicizza l'intero repository in ogni prompt, le richieste grandi costeranno di più e si avvicineranno a quel tetto. Riduci il contesto ai file che ti servono davvero.

Privacy e dove leggere di più

I prompt non sono usati per l'addestramento. Tuttavia, il codice sorgente contiene spesso segreti, quindi tieni i file .env e le credenziali fuori dai file che alleghi a una chat. La maggior parte delle estensioni ti permette di escludere percorsi dal contesto.

Il modello è solo testo. Risponde a domande di codifica, stacca funzioni, spiega errori e supporta la chiamata di funzioni e la modalità JSON, ma non genera immagini, audio o video. Per i campi della richiesta e gli esempi oltre questa pagina, leggi la documentazione API. Se qualcosa fallisce ancora dopo i controlli sopra, l'articolo precedente sugli errori comuni dell'API Qwen elenca altri pattern di errore con le relative correzioni.

Domande e risposte

Dove ottengo una chiave API Qwen per VS Code?

Registrati sul sito, apri la pagina della chiave API e creane una. Puoi anche richiedere il credito di prova da $0,50 con un clic lì, senza bisogno di carta.

Quale URL di base inserisco nell'estensione?

Usa https://api.uncensoredqwen.com/v1 e ometti /chat/completions. L'ID del modello è uncensored.

Perché la mia estensione restituisce 401?

La chiave è solitamente sbagliata, ha uno spazio di troppo o appartiene a un altro account. Ricopiala e testala con la chiamata curl a /v1/models.

Posso usarlo per l'autocompletamento con Tab?

Funziona attraverso le impostazioni di autocompletamento compatibili con OpenAI, ma le richieste frequenti possono raggiungere il limite di prova di 60 al minuto. Una chiave completa permette 300 al minuto.

La tua chiave è a un passo di distanza

Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.

Ottieni la chiave API