Was du vor dem Öffnen von VS Code brauchst
Ein qwen API-Schlüssel für VS Code ist nur ein API-Schlüssel plus die richtigen Endpunkt-Einstellungen in einer Erweiterung. Sammle zuerst diese drei Werte:
- Basis-URL:
https://api.uncensoredqwen.com/v1 - Modell-ID:
uncensored - API-Schlüssel: erstellt auf der API-Schlüssel-Seite nach der Anmeldung mit Google oder mit E-Mail und Passwort
Neue Konten können auf dieser Seite mit einem Klick $0,50 kostenloses Testguthaben beanspruchen. Es benötigt keine Karte, ist auf eine Person beschränkt und verfällt nach 7 Tagen. Das reicht, um eine Editor-Einrichtung für ein paar Tage echtes Programmieren zu testen.
Ein Hinweis zur Namensgebung: Der Dienst ist ein gehostetes Open-Weight-Modell eines unabhängigen Anbieters. Es ist nicht die offizielle API von Alibaba und kein Router zu anderen Anbietern. In deinem Editor erscheint es unter dem Anzeigenamen, den du ihm gibst.
Teste den Schlüssel zuerst mit curl
Bestätige vor der Änderung von Editor-Einstellungen, dass Schlüssel und URL einzeln funktionieren. Wenn das fehlschlägt, wird keine Erweiterung erfolgreich sein, und du weißt, dass das Problem beim Schlüssel und nicht beim Plugin liegt.
export API_KEY="paste-your-key-here"
curl https://api.uncensoredqwen.com/v1/models \
-H "Authorization: Bearer $API_KEY"
Eine JSON-Liste, die uncensored enthält, bedeutet, dass die Authentifizierung funktioniert. Sende dann eine echte Completion:
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}'
Die Antwort-Header enthalten X-Balance-USD, was eine schnelle Möglichkeit ist, das verbleibende Guthaben zu sehen, ohne das Terminal zu verlassen.
Füge den Anbieter in einer VS Code-Erweiterung hinzu
Mehrere VS Code-Erweiterungen für KI-Programmierungshilfe können mit jedem OpenAI-kompatiblen Server kommunizieren. Die Bezeichnungen unterscheiden sich je nach Tool etwas, aber die Felder entsprechen sich eins zu eins. Suche nach einer Anbieterauswahl, die wie „OpenAI Compatible“, „OpenAI“ mit einer benutzerdefinierten Basis-URL oder „Custom endpoint“ benannt ist.
| Erweiterungsfeld | Einzugebender Wert |
|---|---|
| Anbieter | OpenAI-kompatibel (oder OpenAI mit benutzerdefinierter Basis-URL) |
| Basis-URL / API-Basis | https://api.uncensoredqwen.com/v1 |
| API-Schlüssel | Der Schlüssel aus deinem Konto |
| Modell-ID | uncensored |
Erweiterungen, die eine JSON-Konfigurationsdatei lesen, erwarten meist etwas in dieser Form. Die genauen Schlüsselnamen variieren, also prüfe die Dokumentation deiner Erweiterung und passe die Feldnamen an:
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.uncensoredqwen.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
Committe diese Datei nicht. Wenn deine Einstellungen in einem Repository gespeichert sind, verwende stattdessen die Geheimnisspeicherung der Erweiterung oder eine Umgebungsvariable und füge den Konfigurationspfad zu .gitignore hinzu.
Öffne nach dem Speichern die Chat-Panels der Erweiterung und sende eine kurze Nachricht wie „Erkläre diese Funktion“ bei geöffneter Datei. Eine gestreamte Antwort bedeutet, dass die Einrichtung abgeschlossen ist.
Häufige Konfigurationsfehler beheben
Die meisten fehlgeschlagenen Setups lassen sich auf wenige Tippfehler zurückführen. Gehe diese Liste der Reihe nach durch.
Die URL hat die falsche Form
Die Base URL endet bei /v1. Erweiterungen fügen /chat/completions selbst hinzu. Wenn du den vollständigen Pfad einfügst, erhältst du einen 404-Fehler, weil der Client /v1/chat/completions/chat/completions anfragt. Ein abschließender Slash ist meist harmlos, aber ein fehlendes /v1 nicht.
Der Modellname ist falsch
Einige Erweiterungen füllen eine Auswahlliste für Modelle mit Namen eines anderen Dienstes voraus. Überschreibe sie exakt mit uncensored, in Kleinbuchstaben. Wenn das Feld eine Auswahlliste ohne benutzerdefinierten Eintrag ist, suche nach einer Option „custom model“ oder „other“.
Der Schlüssel enthält Fremdzeichen
Das Kopieren von einer Webseite kann einen nachgestellten Leerraum oder einen Zeilenumbruch hinzufügen. Füge den Text in einen einfachen Texteditor ein, trimme ihn und füge ihn erneut ein. Eine 401-Antwort deutet fast immer auf diesen Fall oder auf einen Schlüssel aus einem anderen Konto hin.
Die Erweiterung spricht weiterhin mit ihrem Standardserver
Wenn sich dein Guthaben nach Chat-Anfragen nicht ändert, nutzt der Editor möglicherweise einen integrierten Anbieter. Prüfe, dass das aktive Modellprofil das ist, das du bearbeitet hast, und lade das Fenster nach Änderungen neu.
Anfragen schlagen mit 429 fehl
Das ist ein Ratenlimit, das im nächsten Abschnitt behandelt wird. Der Fehler-Body enthält einen Code, der angibt, welches Limit du erreicht hast.
Prüfen, ob Anfragen die API wirklich erreichen
Editoren sagen selten, welcher Server geantwortet hat. Zwei schnelle Checks beseitigen Zweifel.
- Behalte das Guthaben im Auge. Führe die
/v1/models- oder eine kurze Completion-Anfrage im Terminal aus, notiere denX-Balance-USD-Header, sende drei Chat-Nachrichten im Editor und wiederhole die Terminal-Anfrage. Der Wert sollte um einen kleinen Betrag sinken. Derselbe Wert ist überGET /v1/balanceverfügbar. - Fordere etwas an, das das Standard-Setup ablehnen oder anders handhaben würde. Ein kleiner, harmloser Test besteht darin, eine Antwort in exakt fünf Wörtern anzufordern. Wenn die Antwort der Anweisung folgt und gestreamt ankommt, ist die Verbindung gesund.
Wenn sich das Guthaben nicht bewegt, öffne das Erweiterungs-Ausgabefenster oder die Entwicklerkonsole. Die meisten Erweiterungen protokollieren die Anfrage-URL und den HTTP-Status, und ein falscher Host fällt sofort auf. Korrigiere die Base URL, lade das Fenster neu und versuche es erneut.
Teams, die ein Repository teilen, sollten jeder Person einen separaten Schlüssel geben, anstatt einen gemeinsamen Wert zu nutzen. So blockiert ein Ratenlimit, das eine Person auslöst, nicht die anderen, und ein geleakter Schlüssel kann ersetzt werden, ohne alle anderen zu stören.
Autocomplete, Chat und Ratenlimits
Chat ist schonend für Limits: eine Anfrage pro Nachricht. Inline-Autocomplete ist anders. Viele Erweiterungen senden bei einer kurzen Tipp-Pause eine Anfrage, was beim Arbeiten Dutzende Aufrufe pro Minute erzeugen kann.
Kenne die Zahlen. Ein voller Schlüssel erlaubt 8 parallele Anfragen und 300 Anfragen pro Minute. Ein Trial-Schlüssel erlaubt 2 parallele und 60 pro Minute. Wenn du sie überschreitest, antwortet die API mit HTTP 429 und dem Code rate_limited (zu viele pro Minute) oder concurrency (zu viele gleichzeitig). Bei temporärer Überlastung erhältst du auch 429 mit einem Retry-After: 5-Header. Eine gestreamte Completion belegt ihren Concurrency-Slot bis zum Stream-Ende, daher zählen langsame Streams länger.
Praktische Einstellungen, die helfen:
- Nutze den Dienst für Chat, Bearbeitungen und Erklärungen und schalte Tab-Autocomplete aus oder erhöhe die Debounce-Verzögerung, während du einen Trial-Schlüssel nutzt.
- Reduziere die maximalen Output-Token für Autocomplete auf einige Dutzend. Kurze Completions sind schnell fertig und geben den Slot frei.
- Vermeide es, während einer Trial-Phase mehrere Editor-Fenster gegen denselben Schlüssel zu betreiben.
Fehlgeschlagene oder abgelehnte Anfragen werden nicht berechnet, daher kosten Fehler nichts außer Zeit.
Kosten einer Coding-Sitzung
Coding-Prompts sind input-lastig, da Erweiterungen Dateiinhalte anhängen. Der Preis beträgt $0,15 pro 1 Mio. Input-Token und $0,50 pro 1 Mio. Output-Token. Betrachte eine Chat-Äußerung, die 6.000 Token Code und Kontext sendet und 800 Token zurückbekommt:
- Input: 6.000 x $0,15 / 1.000.000 = $0,0009
- Output: 800 x $0,50 / 1.000.000 = $0,0004
- Gesamt: $0,0013 pro Durchgang
Bei 100 solchen Äußerungen an einem Arbeitstag sind das $0,13. Das $0,50-Testguthaben deckt etwa 380 solcher Äußerungen ab ($0,50 / $0,0013 sind etwa 385). Das Guthaben ist Prepaid, verfällt nie, und Aufladungen erfolgen in ganzen Beträgen von $20 bis $500, mit einem Bonus von 5 % ab $50, 10 % ab $100 und 15 % ab $200. Sieh dir die Preisseite für Zahlungsmethoden an.
Das Kontextfenster umfasst 100.000 Token, Prompt plus Vervollständigung. Wenn eine Erweiterung dein gesamtes Repository in jeden Prompt indiziert, werden große Anfragen mehr kosten und sich dieser Grenze nähern. Begrenze den Kontext auf die Dateien, die du tatsächlich benötigst.
Datenschutz und weitere Informationen
Prompts werden nicht zum Training verwendet. Da Quellcode jedoch oft Geheimnisse enthält, halte .env-Dateien und Anmeldeinformationen von den Dateien fern, die du einem Chat anhängst. Die meisten Erweiterungen ermöglichen es, Pfade vom Kontext auszuschließen.
Das Modell ist textbasiert. Es beantwortet Coding-Fragen, entwirft Funktionen, erklärt Fehler und unterstützt Function Calling und JSON-Modus, erzeugt jedoch keine Bilder, Audio oder Video. Für Anfragefelder und Beispiele jenseits dieser Seite lies die API-Dokumentation. Wenn nach den oben genannten Prüfungen immer noch etwas fehlschlägt, listet der frühere Artikel zu häufigen Qwen API-Fehlern weitere Fehlermuster mit Lösungen auf.
