# Ključ API za Qwen Code: kje ga ustvariti, kako ga povezati in izračunati porabo

> Kaj je ključ API za Qwen Code, kako se razlikuje od naročnine, kje ga ustvariti, kako nastaviti settings.json in kaj določa porabo žetonov.

Source: https://ailoot.ai/blog/sl/qwen-code-api-key/
Canonical: https://ailoot.ai/blog/sl/qwen-code-api-key/
Language: sl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-141
Revision: sha256-dfa8cbbecf442c747b9d9f1974625566ef9f737dab95ce03035ef3de693cf49f


Nekdo namesti Qwen Code, ga zažene v terminalu in že pri prvi zahtevi program prosi za ključ. Nato se začne iskanje: ljudje vpišejo »buy api key for qwen code« in pristanejo na straneh, kjer prodajajo naročnino ali že pripravljen dostop nekoga drugega. Tukaj je korak za korakom pojasnjeno, kaj je ključ, kje ga dobiti in koliko stane.

Glavno sporočilo že na začetku: nihče ne prodaja ključa API kot ločenega izdelka v škatli. To je dostopni niz, ki ga ustvarite sami v računu ponudnika modela, njegova izdaja pa je brezplačna. Denar boste potrebovali pozneje, ko boste napolnili dobroimetje; pri tem koraku veljajo pogoji ponudnika. Spodaj je pojasnjeno, kje dobiti ključ, kako ga povezati s Qwen Code in koliko stane uporaba.

<div class="aside" data-semantic="callout" role="note" aria-label="Pozor">

Pozor

To gradivo je informativno in opisuje javno dostopna pravila. Ne navaja posredniških storitev, ki ponujajo »urejanje« plačil z obidom omejitev, niti ne pojasnjuje načinov za obid omejitev. Cene so povzete s strani ponudnikov in veljajo za začetek septembra 2026; spreminjajo se, zato aktualne cene preverite na spletnem mestu ponudnika.

</div>

<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Dokumentacija Ailoot">

[Dokumentacija Ailoot](https://ailoot.ai/docs/) — referenčno gradivo o uporabi storitve.

</div>

## Kaj točno je ključ API za Qwen Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ključna ugotovitev">

Ključna ugotovitev

Ključ API za Qwen Code je osebni niz, podoben geslu, s katerim ponudnik storitve prepozna vaše zahteve za model in obračuna njihovo porabo. Sam Qwen Code je brezplačen odprtokodni agent; nima vgrajenega lastnega modela. Odgovore pridobiva od zunanjega ponudnika, pri tem pa mu posreduje vaš ključ. »Pridobiti ključ« torej pomeni registrirati se pri ponudniku in v njegovem računu ustvariti dostopni niz. V tem postopku niz podate prek okoljske spremenljivke zagonskega terminala; nastavitve vsebujejo ime spremenljivke, poraba pa se obračuna vašemu računu.

</div>

Qwen Code je odprtokodni AI-agent, ki deluje v terminalu in piše kodo za vaše naloge. Je brezplačen, namesti se prek npm in v sebi nima lastne nevronske mreže. Vse inteligentno delo opravi model, ki deluje na strežnikih ponudnika.

Qwen Code za dostop do modela potrebuje vstopnico. Ta vstopnica je ključ API — dolg niz, podoben geslu, ki vam ga ponudnik izda osebno. Ko agent pošlje zahtevo, ji priloži ključ; ponudnik ga uporabi za prepoznavo lastnika zahteve, pošlje odgovor in odšteje porabo od vašega dobroimetja.

Iz tega sledi preprosta ugotovitev, ki razjasni polovico nejasnosti. Ključa ne kupite kot izdelka na spletni tržnici: pri ponudniku ustvarite račun, kliknete »ustvari ključ« in niz dobite brezplačno. Iskanje »buy api key« v resnici pomeni »kje ustvarim račun in kako pozneje plačam uporabo«, v nadaljevanju pa so obravnavana oba odgovora.

## Kako se ključ API razlikuje od naročnine in stare brezplačne prijave?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ključna ugotovitev">

Ključna ugotovitev

Qwen Code podpira več načinov avtentikacije in obračunavanja. Stara brezplačna raven Qwen OAuth je bila ukinjena 15. aprila 2026. Alibaba Coding Plan uporablja naročnino in namensko končno točko; običajni ključ API za Model Studio se obračunava po porabi. Trenutni odjemalci ponujajo tudi druge platforme in pakete. Ta vodič obravnava običajni ključ API za Model Studio: regija, končna točka, model in način obračunavanja morajo soditi skupaj.

</div>

V Qwen Code ukaz `/auth` prikaže možnosti avtentikacije, ki jih podpira nameščena različica. Izberite platformo, ki je izdala ključ, in njen način obračunavanja. Spodaj razlikujemo staro brezplačno prijavo, Coding Plan in običajni ključ API v tem vodiču; to ni izčrpen seznam današnjih vnosov v meniju.

Prva možnost je brezplačna prijava z računom Qwen (Qwen OAuth). Včasih je omogočala dostop do modela brez ključa, vendar so jo ukinili.

<figure>
<blockquote>
<p>Brezplačna stopnja Qwen OAuth je bila ukinjena 15. aprila 2026. Prej shranjeni žetoni bodo morda še nekaj časa delovali, nove zahteve pa bodo zavrnjene.</p>
</blockquote>
<figcaption>— Dokumentacija Qwen Code, preverjanje pristnosti, uradna dokumentacija</figcaption>
</figure>

Druga možnost je naročnina Alibaba ModelStudio Coding Plan. Plačuje se fiksno mesečno, vključuje tedensko kvoto zahtev in uporablja ločen naslov za povezavo.

Tretja možnost je ključ API ponudnika modela. Ni fiksne naročnine: dobroimetje napolnite in ga porabljate med delom glede na porabo žetonov. Ta možnost je prilagodljiva in primerna, če agenta uporabljate neredno. Preostanek članka je namenjen tej možnosti.

## Kje lahko ustvarite ključ API za Qwen Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ključna ugotovitev">

Ključna ugotovitev

Qwen Code se lahko poveže z več ponudniki in protokoli. Za neposredno povezavo z Alibaba Model Studio pred ustvarjanjem ključa v konzoli Model Studio izberite regijo. Ključ, osnovni URL API, delovni prostor in razpoložljivi model se morajo ujemati z regijo. Mednarodni naslov konzole ali angleški vmesnik sama po sebi ne določata regije API.

</div>

Ker Qwen Code podpira različne protokole, niste omejeni na enega samega ponudnika ključev. Uradna dokumentacija izrecno navaja storitve, s katerimi se lahko poveže.

<figure>
<blockquote>
<p>Podpira protokole OpenAI, Anthropic, Gemini in Qwen. Katerikoli ponudnik tretje osebe ali lokalni model. Preklapljanje sproti.</p>
</blockquote>
<figcaption>— Dokumentacija Qwen Code, preverjanje pristnosti, uradna dokumentacija</figcaption>
</figure>

Spodaj je opisana možnost neposredne povezave.

Za neposredno pot odprite [konzolo Alibaba Model Studio](https://modelstudio.console.alibabacloud.com/), izberite regijo in na strani za upravljanje ključev API ustvarite ključ. Ob konfiguraciji hranite regijo in ime delovnega prostora; ključa ne kopirajte v skupne zapiske.

| Regija izbranega ključa | Običajni osnovni URL, združljiv z OpenAI | Kaj preveriti |
|----|----|----|
| Kitajska (Peking) | `DASHSCOPE_BASE_URL` | Ključ za Peking in model, razpoložljiv v tej regiji |
| Singapur | `DASHSCOPE_BASE_URL` | Ključ za Singapur in model, razpoložljiv v tej regiji |
| ZDA (Virginija), vključno z obsegom namestitve Global ali US | Iz izbranega ameriškega delovnega prostora kopirajte API Host in uporabite njegov dokumentirani osnovni URL, združljiv z OpenAI | Ključ ameriškega delovnega prostora, obseg namestitve in seznam modelov; ne uporabite naslova za Peking ali Singapur |

[Regionalni vodič](https://www.alibabacloud.com/help/en/model-studio/regions) za produkcijo priporoča domene, namenjene delovnemu prostoru. Dejanski API Host kopirajte iz Workspace Management in sledite [vodiču za osnovni URL](https://www.alibabacloud.com/help/en/model-studio/base-url); ne izmišljajte ID-ja delovnega prostora. Skupne končne točke DashScope in namenske končne točke delovnega prostora so različne možnosti dostopa. Tudi Coding Plan in Token Plan uporabljata svoje končne točke in ključe. Iz konzole delovnega prostora v izbrani regiji kopirajte celoten osnovni URL, združljiv z OpenAI, v `DASHSCOPE_BASE_URL`. JSON izpusti `baseUrl`; pred zagonom naslov podate prek `OPENAI_BASE_URL`. Uporabite dejanske vrednosti iz konzole, ne nadomestnega ID-ja prostora.

Obstaja tudi brezplačna možnost, za katero ne potrebujete ključa: model Qwen zaženete v svojem računalniku prek Ollama in nanj povežete Qwen Code kot na svoj strežnik. Potrebujete zmogljiv računalnik in ločeno nastavitev. Kako zagnati agenta lokalno, je prikazano v vodiču [zagon Qwen Code v terminalu](https://ailoot.ai/blog/sl/qwen-code-terminal-auto-edit/).



## Kako dodati ključ v Qwen Code, da bo deloval?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ključna ugotovitev">

Ključna ugotovitev

V `~/.qwen/settings.json` nastavite protokol, regionalni osnovni URL, ID modela in `envKey`, ime okoljske spremenljivke, ki poda ključ. Skrivne vrednosti ne zapisujte v ta JSON. Qwen Code zaženite iz terminala s to spremenljivko, preverite povezavo in pošljite en kratek poziv, preden nastavitev štejete za uporabno. `/model` izpiše nastavljene izbire; sam po sebi ne dokazuje dostopa do ponudnika.

</div>

Obstoječe nastavitve varnostno kopirajte in spodnjo povezavo združite z `~/.qwen/settings.json`; ne prepišite drugih ponudnikov ali nastavitev. Ponazoritev sledi [primeru avtentikacije Qwen Code](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) z URL-jem delovnega prostora prek `OPENAI_BASE_URL`, ključem API iz okoljske spremenljivke, imenovane v `envKey`, in brez bloka `env` s skrivnostjo v navadnem besedilu. `qwen3-coder-plus` je model iz uradnega primera; najprej potrdite, da ga vaša regija/račun ponuja, ali na obeh mestih uporabite dejanski ID modela iz konzole te regije.

Iz konzole delovnega prostora v izbrani regiji kopirajte celoten osnovni URL, združljiv z OpenAI, v `DASHSCOPE_BASE_URL`. JSON izpusti `baseUrl`; pred zagonom naslov podate prek `OPENAI_BASE_URL`. Uporabite dejanske vrednosti iz konzole, ne nadomestnega ID-ja prostora.

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

`openai` izbere združljivi protokol. `envKey` poimenuje spremenljivko, ki jo bere Qwen Code; to ni vrednost ključa. `model.name` se mora ujemati z nastavljenim `id`. Polja dokumentira [referenca ponudnikov modelov](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/).

V macOS ali Linux odprite terminal Bash, ključ vnesite v skriti poziv in v istem terminalu zaženite Qwen Code:

```bash
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
```

V Windows uporabite PowerShell:

```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
```

Ukazi preprečijo zapis dobesedne skrivnosti v JSON in zgodovino ukazov; delujoči proces jo še vedno prejme v okolju. Ne izpisujte je, ne zapisujte v Git in je ne lepite v poziv. Ob prehodu na ta način iz nastavitev odstranite stari vnos `env`, ki vsebuje skrivnost. V novem terminalu morate spremenljivko podati znova.

V Qwen Code z `/doctor` preglejte avtentikacijo, z `/model` pa izbrano nastavitev. V neškodljivi prazni preizkusni mapi pošljite: »Odgovori z besedo connected. Ne beri ali spreminjaj datotek in ne izvajaj ukazov.« Uspešen odgovor preveri eno zahtevo modelu in lahko povzroči strošek porabe. Prikaz modela v `/model` potrdi le lokalno konfiguracijo.

Ob napaki shranite sporočilo brez skrivnosti in ID zahteve, če je podan. Avtentikacijo preverite ločeno od razpoložljivosti modela in obračunavanja: v isti konzoli ponudnika preverite platformo izdaje ključa, regijo/delovni prostor, standardno ali paketno končno točko, ID modela in dobroimetje/kvoto. Koda 401 lahko pomeni neujemanje ključa/končne točke ali plačilnega paketa; ne dokazuje okvare ponudnika. Po neuspelem preverjanju se ustavite in pred ponovitvijo popravite dokumentirano neujemanje. Članek opisuje primer na podlagi dokumentacije, ne plačljive zahteve, izvedene za ta vodič.

## Koliko stane uporaba ključa API in zaradi česa se račun poveča?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ključna ugotovitev">

Ključna ugotovitev

Pri ključu API plačate po porabi: za vsakih tisoč vhodnih in izhodnih žetonov velja določena cena, brez fiksnega mesečnega zneska. Lažji modeli, kot je Qwen3-Coder-Flash, so večkrat cenejši. Račun se povečuje s količino dela: daljše ko so vaše datoteke in več ko jih agent bere in piše, večja je poraba. Za točno ceno vedno preverite stran ponudnika; cena se spreminja.

</div>

Ključ se od naročnine razlikuje po tem, da ni fiksnega mesečnega zneska. Plačate za to, kar model prebere in napiše, merjeno v žetonih. Žeton je del besedila, dolg približno nekaj črk. Vsak model ima svojo ceno na milijon vhodnih in na milijon izhodnih žetonov; izhodni žetoni so skoraj vedno dražji od vhodnih.

Milijon žetonov se sliši veliko, vendar ga pri delu na velikem projektu porabite hitreje, kot bi pričakovali: agent ob vsaki zahtevi v celoti prebere vaše datoteke.

Praktični sklep je naslednji: račun je odvisen od količine besedila, ki ga obdela agent. Dolge datoteke, dolge seje in stalno ponovno branje kode najhitreje porabljajo vaše dobroimetje; število nalog je drugotnega pomena. V ločenem članku je korak za korakom pojasnjeno, [kako se izračuna poraba žetonov API](https://ailoot.ai/blog/sl/api-token-usage-calculation/) in zakaj lahko dobroimetje neopazno kopni.

## Zakaj so plačila zavrnjena?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ključna ugotovitev">

Ključna ugotovitev

Če želite začeti porabljati dobroimetje prek ključa, ga morate najprej napolniti. Če plačilni sistem zavrne vašo kartico zaradi banke izdajateljice, sprememba e-poštnega naslova, jezika ali nastavitev profila ne spremeni pogojev te kartice.

</div>

Tu se zgodi pogosta napaka.

Težava se pojavi šele korak pozneje. Ključ ste ustvarili, vendar brez denarja na dobroimetju z njim ne morete ničesar porabiti — ponudnik vrne napako insufficient funds.

Če je zavrnitev povezana z banko, ki je izdala kartico, sprememba e-poštnega naslova, jezika vmesnika ali nastavitev profila ne spremeni plačilnih pogojev. Mehanizem je pojasnjen na primeru [tuje kartice za Claude](https://ailoot.ai/blog/sl/claude-card-payment-requirements/).

Upoštevajte tudi, da končno odločitev sprejme plačilni prehod. Plačilo lahko zavrne iz lastnih razlogov in ni zagotovila, da bo uspelo.

## Kje začeti?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ključna ugotovitev">

Ključna ugotovitev

Razlikujte načine avtentikacije in obračunavanja: stari brezplačni Qwen OAuth je ukinjen, Coding Plan ima svojo končno točko in naročnino, običajni ključ Model Studio pa se obračuna po porabi. Vodič uporablja zadnjo možnost. Ključ ustvarite v izbrani regiji in delovnem prostoru, povezavo združite brez skrivnosti v JSON in ključ podajte prek okolja terminala. Za polnjenje dobroimetja potrebujete kartico, ki jo sprejme plačilni prehod. Če ustreza nalogi in porabi, izberite razpoložljiv lažji model.

</div>

Kratek načrt po korakih:

1.  Preverite možnosti avtentikacije svoje različice. Stari brezplačni Qwen OAuth je ukinjen; Coding Plan ima ločeno naročnino/končno točko. Tukaj uporabljamo običajni ključ API za Model Studio z obračunom po porabi.
2.  Ustvarite račun pri ponudniku. Najpreprostejša možnost je neposredno Alibaba.
3.  Ustvarite ključ v računu ponudnika, v razdelku za dostopne ključe. Ustvarjanje je brezplačno; za to ne potrebujete kartice.
4.  Regionalno povezavo združite z `~/.qwen/settings.json` brez skrivne vrednosti. V zagonskem terminalu podajte `DASHSCOPE_API_KEY`, nato preverite izbrani model in en kratek odgovor, kot je prikazano zgoraj.
5.  Za plačilo uporabe potrebujete kartico, izdano na vaše ime, ki jo sprejme plačilni prehod ponudnika. Pogoje polnjenja določa plačilni prehod; ustvarjanje ključa in plačevanje uporabe sta ločena koraka.

Vredno je razmisliti tudi o tem, kateri model potrebujete. Za zahtevne naloge izberite zmogljivejši Qwen3-Coder-Plus; če želite prihraniti, izberite lažji Flash, ki je pri enakem obsegu večkrat cenejši. Vodič [Qwen Code kot zamenjava za Claude Code](https://ailoot.ai/blog/sl/qwen-code-token-plan-setup/) prikazuje, kako se Qwen Code razlikuje od drugih terminalskih agentov.

<div class="section" role="doc-bibliography" aria-label="Viri">

### Viri

- [Qwen Code - repozitorij GitHub](https://github.com/QwenLM/qwen-code) - odprtokodna koda agenta, namestitev, podpora za več protokolov in povezovanje s ponudniki tretjih oseb
- [Qwen Code - dokumentacija za preverjanje pristnosti](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) - tri možnosti prijave, ukinitev brezplačnega OAuth 15.04.2026 in nastavitev ključa prek settings.json
- [Alibaba Model Studio – konzola](https://modelstudio.console.alibabacloud.com/) – pred ustvarjanjem običajnega ključa API izberite regijo in delovni prostor

</div>



Več gradiva je na voljo na [Ailoot](https://ailoot.ai/).

## Pogosta vprašanja o ključu API za Qwen Code

### Ali je izdaja ključa API enaka nakupu uporabe modela?

Ne. Izdaja dostopnega niza je ločena od financiranja porabe. Ponudnik prek ključa prepozna in meri zahteve; sam izdani ključ ne potrjuje uporabnega dobroimetja ali kvote računa.

### Kaj se mora ujemati v nastavitvi ponudnika Qwen Code?

Izbrani protokol, osnovni URL ponudnika, okoljska spremenljivka s ključem in identifikator modela morajo pripadati isti povezavi. V primeru se model.name ujema z id vnosa modelProviders; pravi ključ izključite iz deljenih kopij nastavitev.


## Ailoot · Podjetje in njegov portfelj projektov

Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI.

Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.

Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.