Wat je nodig hebt voordat je VS Code opent
Een qwen API-sleutel voor VS Code is gewoon een API-sleutel plus de juiste endpoint-instellingen in een extensie. Verzamel eerst deze drie waarden:
- Basis-URL:
https://api.uncensoredqwen.com/v1 - Model ID:
uncensored - API-sleutel: aangemaakt op de API-sleutelpagina nadat je je hebt aangemeld met Google of met e-mail en wachtwoord
Nieuwe accounts kunnen $0,50 aan proeftegoed claimen met één klik op die pagina. Het vereist geen creditcard, is beperkt tot één per persoon en is 7 dagen geldig. Dat is genoeg om een editor-setup een paar dagen te testen voor echt programmeerwerk.
Een opmerking over de naamgeving: de service is een gehost open-weight model uitgevoerd door een onafhankelijke provider. Het is niet de officiële API van Alibaba, en het is geen router naar andere leveranciers. In je editor verschijnt het onder de weergavenaam die je eraan geeft.
Test de sleutel eerst met curl
Voordat je editorinstellingen wijzigt, bevestig dan dat de sleutel en URL op zichzelf werken. Als dit faalt, zal geen enkele extensie slagen, en weet je dat het probleem bij de sleutel ligt en niet bij de plugin.
export API_KEY="paste-your-key-here"
curl https://api.uncensoredqwen.com/v1/models \
-H "Authorization: Bearer $API_KEY"
Een JSON-lijst die uncensored bevat, betekent dat de authenticatie werkt. Stuur daarna één echte voltooiing:
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}'
De antwoordkoppen bevatten X-Balance-USD, wat een snelle manier is om je resterende tegoed te zien zonder de terminal te verlaten.
De provider toevoegen in een VS Code-extensie
Verschillende VS Code-extensies voor AI-codhulp kunnen communiceren met elke OpenAI-compatible server. De labels verschillen iets per tool, maar de velden komen één-op-één overeen. Zoek naar een providerkeuze genaamd "OpenAI Compatible", "OpenAI" met een aangepaste base URL, of "Custom endpoint".
| Extensieveld | In te voeren waarde |
|---|---|
| Aanbieder | OpenAI-compatible (of OpenAI met aangepaste base URL) |
| Base URL / API-basis | https://api.uncensoredqwen.com/v1 |
| API-sleutel | De sleutel van je account |
| Model-ID | uncensored |
Extensies die een JSON-configuratiebestand lezen, willen meestal iets in deze vorm. De exacte sleutelnamen variëren, dus controleer de documentatie van je extensie en pas de veldnamen aan:
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.uncensoredqwen.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
Commit dit bestand niet. Als je instellingen in een repository staan, gebruik dan de geheime opslag van de extensie of een omgevingsvariabele, en voeg het configuratiepad toe aan .gitignore.
Na het opslaan open je het chatpaneel van de extensie en stuur je een kort bericht zoals "Leg deze functie uit" met een bestand open. Een gestreamd antwoord betekent dat de setup klaar is.
Veelvoorkomende configuratiefouten oplossen
De meeste mislukte setups komen neer op een handvol typefouten. Werk deze lijst in volgorde af.
De URL heeft de verkeerde vorm
De base URL eindigt bij /v1. Extensies voegen zelf /chat/completions toe. Als je het volledige pad plakt, krijg je een 404 omdat de client /v1/chat/completions/chat/completions opvraagt. Een eindstreep is meestal onschuldig, maar een ontbrekende /v1 is dat niet.
De modelnaam is verkeerd
Sommige extensies vullen een model-dropdown automatisch in met namen van een andere service. Overschrijf dit met uncensored exact, in kleine letters. Als het veld een dropdown is zonder aangepaste invoer, zoek dan naar een optie "custom model" of "other".
De sleutel heeft vreemde tekens
Kopiëren vanaf een webpagina kan een eindspatie of een nieuwe regel toevoegen. Plak in een platte teksteditor, verwijder de spaties en plak opnieuw. Een 401-antwoord wijst bijna altijd op dit probleem of op een sleutel van een ander account.
De extensie communiceert nog steeds met de standaardserver
Als je saldo niet verandert na chatverzoeken, kan de editor een ingebouwde provider gebruiken. Controleer dat het actieve modelprofiel degene is die je hebt bewerkt, en herlaad het venster na het wijzigen van instellingen.
Verzoeken falen met 429
Dat is een rate limit, behandeld in de volgende sectie. De error body bevat een code die aangeeft welke limiet je hebt geraakt.
Controleren of verzoeken de API echt bereiken
Editors vertellen zelden welke server heeft geantwoord. Twee snelle controles wekken de twijfel weg.
- Houd het saldo in de gaten. Voer de
/v1/modelsof een kort completion-verzoek uit vanuit de terminal, noteer deX-Balance-USDheader, stuur drie chatberichten in de editor en herhaal daarna het terminalverzoek. Het aantal moet met een klein bedrag dalen. Dezelfde figuur is beschikbaar viaGET /v1/balance. - Vraag om iets dat de standaardsetup zou weigeren of anders zou afhandelen. Een kleine, onschadelijke test is om een antwoord te vragen in precies vijf woorden. Als het antwoord de instructie volgt en gestreamd aankomt, is de verbinding gezond.
Als het saldo niet verandert, open dan het outputpaneel van de extensie of de ontwikkelaarsconsole. De meeste extensies loggen de request URL en de HTTP-status, en een verkeerde host valt direct op. Los de base URL op, herlaad het venster en probeer opnieuw.
Teams die een repository delen, moeten elke persoon een aparte sleutel geven in plaats van één gedeelde waarde. Op die manier blokkeert een rate limit die door één persoon wordt geraakt, de anderen niet, en kan een gelekte sleutel worden vervangen zonder iedereen anders te storen.
Autocomplete, chat en rate limits
Chat is mild voor limieten: één verzoek per bericht. Inline autocomplete is anders. Veel extensies sturen een verzoek na een korte pauze tijdens het typen, wat tientallen calls per minuut kan opleveren terwijl je werkt.
Ken de cijfers. Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. Een proefsleutel staat 2 gelijktijdige en 60 per minuut toe. Wanneer je ze overschrijdt, antwoordt de API met HTTP 429 en de code rate_limited (te veel per minuut) of concurrency (te veel tegelijk). Bij tijdelijke overbelasting krijg je ook 429 met een Retry-After: 5 header. Een gestreamde completion houdt zijn concurrency slot vast tot de stream eindigt, dus langzame streams tellen langer mee.
Praktische instellingen die helpen:
- Gebruik de service voor chat, bewerkingen en uitleg, en zet tab-autocomplete uit of verhoog de debounce-vertraging tijdens het gebruik van een proefsleutel.
- Verlaag het maximum aantal output tokens voor autocomplete tot een paar tientallen. Korte completions zijn snel klaar en vrijen het slot.
- Vermijd het draaien van meerdere editorvensters tegen dezelfde sleutel tijdens een proefperiode.
Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus fouten kosten niets behalve tijd.
Kosten van een codesessie
Coding prompts zijn input-intensief omdat extensies bestandsinhoud toevoegen. De prijzen zijn $0,15 per 1M input tokens en $0,50 per 1M output tokens. Overweeg één chatbeurt die 6.000 tokens aan code en context verstuurt en 800 tokens terugkrijgt:
- Input: 6.000 x $0,15 / 1.000.000 = $0,0009
- Output: 800 x $0,50 / 1.000.000 = $0,0004
- Totaal: $0,0013 per beurt
Bij 100 zulke beurten op een werkdag is dat $0,13. Het $0,50 proeftegoed dekt ongeveer 380 beurten van deze grootte ($0,50 / $0,0013 is ongeveer 385). Het tegoed is prepaid, verloopt nooit, en opwaarderingen zijn vaste bedragen van $20 tot $500, met een bonus van 5% vanaf $50, 10% vanaf $100 en 15% vanaf $200. Zie de prijzenpagina voor betaalmethoden.
Het contextvenster is 100.000 tokens, prompt plus completion. Als een extensie je hele repository indexeert in elke prompt, zullen grote verzoeken meer kosten en die plafond benaderen. Beperk het contextvenster tot de bestanden die je echt nodig hebt.
Privacy en waar je meer kunt lezen
Prompts worden niet gebruikt voor training. Broncode bevat echter vaak geheimen, dus houd .env-bestanden en referenties buiten de bestanden die je aan een chat toevoegt. De meeste extensies laten je paden uitsluiten van de context.
Het model is alleen tekst. Het beantwoordt coderingsvragen, schrijft functies, legt fouten uit en ondersteunt function calling en JSON-modus, maar het genereert geen afbeeldingen, audio of video. Voor request velden en voorbeelden buiten deze pagina, lees de API-documentatie. Als er na de bovenstaande controles nog steeds iets misgaat, somt het eerdere artikel over veelgemaakte Qwen API-fouten meer foutpatronen op met oplossingen.
