Qwen Code: klucz API, konfiguracja i obliczanie zużycia

Ktoś instaluje Qwen Code, uruchamia go w terminalu, a przy pierwszym żądaniu program prosi o klucz. Zaczynają się więc poszukiwania: użytkownicy wpisują „kup klucz api do qwen code” i trafiają na strony, na których sprzedaje się im subskrypcję albo gotowy dostęp należący do kogoś innego. Oto, czym jest klucz, gdzie go uzyskać i ile kosztuje — krok po kroku.

Najważniejsze na początek: nikt nie sprzedaje klucza API jako osobnego produktu w pudełku. To ciąg znaków zapewniający dostęp, który generujesz samodzielnie na koncie dostawcy modelu, a jego wygenerowanie jest bezpłatne. Pieniądze będą potrzebne później, podczas doładowania salda; na tym etapie obowiązują warunki dostawcy. Poniżej wyjaśniamy, gdzie uzyskać klucz, jak połączyć go z Qwen Code i ile kosztuje korzystanie z niego.

Czym dokładnie jest klucz API do Qwen Code?#

Qwen Code to agent AI o otwartym kodzie źródłowym, który działa w terminalu i pisze kod na potrzeby Twoich zadań. Jest darmowy, instaluje się go przez npm i nie ma wbudowanej własnej sieci neuronowej. Całą pracę wymagającą inteligencji wykonuje model działający na serwerach dostawcy.

Qwen Code potrzebuje przepustki, żeby uzyskać dostęp do modelu. Tą przepustką jest klucz API — długi ciąg znaków przypominający hasło, który dostawca wystawia osobiście Tobie. Gdy agent wysyła żądanie, dołącza klucz; dostawca używa go, by ustalić, czyje to żądanie, odpowiada, a następnie odlicza zużycie od Twojego salda.

Prowadzi to do prostej konkluzji, która rozwiewa połowę wątpliwości. Klucza nie kupuje się jako produktu na marketplace: zakładasz konto u dostawcy, klikasz „utwórz klucz” i bezpłatnie otrzymujesz ciąg znaków. Wyszukiwanie „kup klucz api” tak naprawdę oznacza „gdzie założyć konto i jak później zapłacić za korzystanie”, a poniżej odpowiadamy na oba pytania.

Czym klucz API różni się od subskrypcji i dawnego bezpłatnego logowania?#

W Qwen Code polecenie /auth pokazuje metody uwierzytelniania obsługiwane przez zainstalowaną wersję. Wybierz pozycję odpowiadającą platformie, która wydała klucz, i jej planowi rozliczeń. Poniższe rozróżnienie wyjaśnia dawne bezpłatne logowanie, Coding Plan i używany tu standardowy klucz API; nie jest pełną listą dzisiejszych pozycji menu.

Pierwszą opcją jest bezpłatne logowanie przez konto Qwen (Qwen OAuth). Wcześniej zapewniało dostęp do modelu bez klucza, ale zostało wycofane.

Drugą opcją jest subskrypcja Coding Plan w Alibaba ModelStudio. To stała opłata miesięczna, która zapewnia tygodniowy limit żądań i osobny adres połączenia.

Trzecią opcją jest klucz API od dostawcy modelu. Nie ma stałej opłaty: doładowujesz saldo i zużywasz środki w miarę pracy, według licznika tokenów. Ta opcja jest elastyczna i sprawdza się, jeśli korzystasz z agenta nieregularnie. Reszta tego artykułu dotyczy właśnie jej.

Gdzie można wygenerować klucz API do Qwen Code?#

Ponieważ Qwen Code obsługuje różne protokoły, nie musisz ograniczać się do jednego dostawcy klucza. Oficjalna dokumentacja wyraźnie wymienia usługi, z którymi można się połączyć.

Poniżej opisujemy ścieżkę bezpośredniego połączenia.

Dla połączenia bezpośredniego otwórz konsolę Alibaba Model Studio, wybierz zamierzony region i utwórz klucz na stronie zarządzania kluczami API. Zachowaj nazwę regionu i obszaru roboczego przy konfiguracji; nie kopiuj klucza do udostępnianych notatek.

Poradnik regionalny zaleca w produkcji domeny przypisane do obszaru roboczego. Skopiuj rzeczywisty API Host z Workspace Management i postępuj zgodnie z poradnikiem bazowych URL; nie wymyślaj identyfikatora obszaru roboczego. Istniejące współdzielone endpointy DashScope i endpointy przypisane do obszaru roboczego to różne sposoby dostępu. Coding Plan i Token Plan również mają własne endpointy i klucze. Skopiuj pełny bazowy URL zgodny z OpenAI z konsoli obszaru roboczego w wybranym regionie do DASHSCOPE_BASE_URL. JSON pomija baseUrl; przed uruchomieniem adres jest przekazywany przez OPENAI_BASE_URL. Użyj rzeczywistych wartości z konsoli, nie symbolicznego ID obszaru.

Jest też bezpłatna opcja, która nie wymaga żadnego klucza: uruchom model Qwen na swoim komputerze przez Ollama i połącz z nim Qwen Code, traktując go jako własny serwer. Wymaga to wydajnego komputera i osobnej konfiguracji. Sposób lokalnego uruchomienia agenta pokazano w instrukcji uruchamiania Qwen Code w terminalu.

Jak dodać klucz do Qwen Code, aby zaczął działać?#

Zrób kopię obecnych ustawień i scal poniższe połączenie z ~/.qwen/settings.json; nie nadpisuj innych dostawców ani preferencji. Ta przykładowa konfiguracja opiera się na przykładzie uwierzytelniania Qwen Code z adresem URL obszaru roboczego przekazanym przez OPENAI_BASE_URL, kluczem API odczytywanym ze zmiennej środowiskowej wskazanej przez envKey i bez bloku env z jawną wartością klucza. qwen3-coder-plus to model z oficjalnego przykładu; najpierw potwierdź, że jest dostępny dla wybranego regionu i konta, albo w obu miejscach użyj rzeczywistego identyfikatora modelu z konsoli tego regionu.

Skopiuj pełny bazowy URL zgodny z OpenAI z konsoli obszaru roboczego w wybranym regionie do DASHSCOPE_BASE_URL. JSON pomija baseUrl; przed uruchomieniem adres jest przekazywany przez OPENAI_BASE_URL. Użyj rzeczywistych wartości z konsoli, nie symbolicznego ID obszaru.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

openai wybiera zgodny protokół. envKey nazywa zmienną, którą odczytuje Qwen Code; nie jest wartością klucza. model.name musi odpowiadać skonfigurowanemu id. Pola te opisuje dokumentacja dostawców modeli.

W macOS lub Linux otwórz terminal Bash, wprowadź klucz w ukrytym monicie, a potem uruchom Qwen Code w tym samym terminalu:

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

W Windows użyj PowerShell:

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

Te polecenia nie zapisują dosłownego sekretu w JSON ani historii poleceń; uruchomiony proces nadal otrzymuje go w swoim środowisku. Nie wypisuj klucza, nie dodawaj go do repozytorium i nie wklejaj do promptu. Przy przejściu na tę ścieżkę usuń stary wpis env zawierający sekret z ustawień. Nowy terminal wymaga ponownego dostarczenia zmiennej.

W Qwen Code użyj /doctor, aby sprawdzić uwierzytelnianie, i /model, aby sprawdzić wybraną konfigurację. W nieszkodliwym pustym folderze testowym wyślij: „Odpowiedz słowem connected. Nie czytaj ani nie zmieniaj plików i nie wykonuj poleceń.” Poprawna odpowiedź testuje jedno żądanie do modelu i może naliczyć opłatę za zużycie. Obecność modelu na liście /model potwierdza tylko konfigurację lokalną.

Jeśli żądanie się nie powiedzie, zapisz zredagowany błąd i identyfikator żądania, jeśli go podano. Sprawdź uwierzytelnianie osobno od dostępności modelu i rozliczeń: platformę wydania klucza, region i obszar roboczy, endpoint standardowy lub planu, identyfikator modelu oraz saldo i limit konta w tej samej konsoli dostawcy. Kod 401 może wynikać z niedopasowania klucza i endpointu albo planu rozliczeń; nie dowodzi awarii dostawcy. Po nieudanym teście zatrzymaj się i popraw udokumentowane niedopasowanie przed kolejną próbą. Artykuł opisuje przykład oparty na dokumentacji, a nie płatne żądanie wykonane na potrzeby poradnika.

Ile kosztuje korzystanie z klucza API i co powoduje wzrost rachunku?#

Klucz różni się od subskrypcji tym, że nie ma stałej opłaty miesięcznej. Płacisz za to, co model odczytuje i zapisuje, mierzone w tokenach. Token to fragment tekstu o długości mniej więcej kilku liter. Każdy model ma własne stawki za milion tokenów wejściowych i milion tokenów wyjściowych, przy czym tokeny wyjściowe niemal zawsze kosztują więcej niż wejściowe.

Milion tokenów brzmi jak dużo, ale podczas pracy nad dużym projektem zużywa się szybciej, niż można się spodziewać: przy każdym żądaniu agent odczytuje Twoje pliki w całości.

W praktyce rachunek zależy od ilości tekstu przetwarzanego przez agenta. Długie pliki, długie sesje i ciągłe ponowne odczytywanie kodu najszybciej uszczuplają saldo; liczba zadań ma drugorzędne znaczenie. Osobny artykuł krok po kroku wyjaśnia, jak oblicza się zużycie tokenów API i dlaczego może ono znikać niezauważenie.

Dlaczego płatności są odrzucane?#

W tym miejscu często dochodzi do pomyłki.

Problem pojawia się o krok później. Klucz został wygenerowany, ale bez środków na saldzie nie da się niczego użyć — dostawca zwróci błąd informujący o niewystarczających środkach.

Jeśli odrzucenie wynika z banku, który wydał kartę, zmiana adresu e-mail, języka interfejsu czy ustawień profilu nie zmienia warunków płatności. Mechanizm ten wyjaśniono na przykładzie karty zagranicznej do Claude.

Pamiętaj też, że ostateczną decyzję podejmuje bramka płatnicza. Może odrzucić płatność z własnych powodów i nie ma gwarancji, że transakcja zostanie zrealizowana.

Od czego zacząć?#

Krótki plan krok po kroku:

1. W /auth sprawdź opcje swojej wersji Qwen Code i wybierz platformę wydania klucza oraz plan rozliczeń. Dalszy opis dotyczy standardowego klucza API Model Studio; dawny Qwen OAuth i subskrypcja Coding Plan są osobnymi ścieżkami.
2. Utwórz konto u dostawcy. Najprostsza opcja to bezpośrednio Alibaba.
3. Wygeneruj klucz na koncie dostawcy, w sekcji kluczy dostępu. Jest to bezpłatne i nie potrzebujesz do tego karty.
4. Scal regionalne połączenie z ~/.qwen/settings.json bez wartości sekretu. Dostarcz DASHSCOPE_API_KEY w terminalu uruchamiającym aplikację, a potem sprawdź wybrany model i jedną krótką odpowiedź zgodnie z powyższym przykładem.
5. Aby zapłacić za korzystanie, potrzebujesz karty wystawionej na Twoje nazwisko i akceptowanej przez bramkę płatniczą dostawcy. Warunki doładowania ustala bramka płatnicza; wygenerowanie klucza i płacenie za korzystanie to oddzielne kroki.

Warto również zastanowić się, którego modelu potrzebujesz. Do wymagających zadań wybierz wyższy model Qwen3-Coder-Plus; jeśli chcesz oszczędzić, wybierz lżejszy Flash, który przy takim samym zużyciu jest kilka razy tańszy. W instrukcji Qwen Code jako zamiennik Claude Code pokazano, czym Qwen Code różni się od innych agentów terminalowych.

Więcej materiałów znajdziesz na Ailoot.