# Tekoäly ja ohjelmointi: Näin hankit API-avaimen Qwen Codeen vuonna 2026: mistä sen saa ja mitä se maksaa > Mikä Qwen Code API-avain on, miten se eroaa tilauksesta, mistä sellaisen voi luoda, miten settings.json määritetään ja mikä määrää tokenien käytön. Source: https://ailoot.ai/blog/fi/qwen-code-api-key/ Canonical: https://ailoot.ai/blog/fi/qwen-code-api-key/ Language: fi Publisher: Ailoot (https://ailoot.ai/) Translation: guide-141 Revision: sha256-80bd18d35b9ba2630d0c81c99e29f3da246926ff0bac00507e7a316c965a28be Joku asentaa Qwen Coden, käynnistää sen terminaalissa, ja heti ensimmäisen pyynnön yhteydessä se pyytää avainta. Sitten alkaa etsiminen: ihmiset kirjoittavat ”osta api-avain qwen codeen” ja päätyvät sivuille, joilla myydään joko tilausta tai jonkun toisen valmiiksi hankkimaa käyttöoikeutta. Tässä kerrotaan vaihe vaiheelta, mikä avain on, mistä sen saa ja mitä se maksaa. Pääasia heti alkuun: kukaan ei myy API-avainta erillisenä, pakattuna tuotteena. Se on käyttöoikeusmerkkijono, jonka luot itse mallipalveluntarjoajan tilillä, ja sen luominen on ilmaista. Rahaa tarvitset myöhemmin, kun lisäät saldoa; silloin sovelletaan palveluntarjoajan ehtoja. Alla kerrotaan, mistä avaimen saa, miten sen yhdistää Qwen Codeen ja mitä käyttö maksaa.
Huomio Tämä aineisto on informatiivinen ja kuvaa julkisia sääntöjä. Siinä ei nimetä välikäsiä, jotka tarjoavat maksujen ”hoitamista” rajoituksia kiertämällä, eikä selitetä tapoja kiertää rajoituksia. Hinnat on poimittu palveluntarjoajien sivuilta syyskuun 2026 alussa. Ne muuttuvat, joten tarkista ajantasaiset hinnat palveluntarjoajan sivustolta.
[Ailoot-dokumentaatio](https://ailoot.ai/docs/) — viitemateriaalia palvelun käyttöön.
## Mikä Qwen Coden API-avain tarkalleen ottaen on?
Tärkein asia Qwen Coden API-avain on henkilökohtainen, salasanaa muistuttava merkkijono, jonka palveluntarjoaja tunnistaa siitä pyyntösi mallille ja laskee niiden käytön. Qwen Code itsessään on maksuton, avoimen lähdekoodin agentti; siihen ei ole rakennettu omaa mallia. Se hakee vastaukset ulkoiselta palveluntarjoajalta ja käyttää siellä sinun avaintasi. ”Avaimen hankkiminen” tarkoittaa siis rekisteröitymistä palveluntarjoajalle ja käyttöoikeusmerkkijonon luomista sen tilillä. Määritä Qwen Codeen avaimen muuttujan nimi ja anna salainen arvo käynnistävässä päätteessä; tarkista yksi mallivastaus ennen yhteyteen luottamista.
Qwen Code on avoimen lähdekoodin tekoälyagentti, joka toimii terminaalissa ja kirjoittaa koodia tehtäviisi. Se on maksuton, asennetaan npm:n kautta eikä sisällä omaa neuroverkkoa. Malli tekee kaiken älykkään työn, ja se toimii palveluntarjoajan palvelimilla. Qwen Code tarvitsee pääsylipun mallin luo. Tämä lippu on API-avain — pitkä, salasanaa muistuttava merkkijono, jonka palveluntarjoaja myöntää henkilökohtaisesti sinulle. Kun agentti lähettää pyynnön, se liittää mukaan avaimen; palveluntarjoaja tunnistaa sen avulla, kenen pyyntö on kyseessä, vastaa ja vähentää käytön saldostasi. Tästä päästään yksinkertaiseen asiaan, joka selventää puolet hämmennyksestä. Avainta ei osteta markkinapaikan tuotteena: luot tilin palveluntarjoajalle, napsautat ”luo avain” ja saat merkkijonon ilmaiseksi. Haku ”osta api-avain” tarkoittaa oikeastaan ”missä luon tilin ja miten maksan käytöstä sen jälkeen”, ja molempiin kysymyksiin vastataan alla. ## Miten API-avain eroaa tilauksesta ja vanhasta maksuttomasta kirjautumisesta?
Tärkein asia Qwen Code tukee useita tunnistautumis- ja laskutusreittejä. Vanha maksuton Qwen OAuth -taso lopetettiin 15. huhtikuuta 2026. Alibaban Coding Plan käyttää tilausta ja omaa päätepistettä; tavallinen Model Studio API-avain käyttää käyttöön perustuvaa laskutusta. Nykyiset ohjelmaversiot tarjoavat myös muita alusta- ja pakettivalintoja. Tämä opas käsittelee tavallista Model Studio API-avainta: pidä sen alue, päätepiste, malli ja laskutuspaketti yhdessä.
Qwen Codessa `/auth` näyttää asennetun version tukemat tunnistautumisvaihtoehdot. Valitse avaimen myöntänyttä alustaa ja sen laskutuspakettia vastaava kohta. Alla erotellaan vanha maksuton kirjautuminen, Coding Plan ja tässä oppaassa käytetty tavallinen API-avain; luettelo ei kata kaikkia nykyisen valikon kohtia. Ensimmäinen vaihtoehto on maksuton kirjautuminen Qwen-tilillä (Qwen OAuth). Se tarjosi aiemmin pääsyn malliin ilman avainta, mutta sen käyttö on lopetettu.

Maksuton Qwen OAuth -taso lopetettiin 15. huhtikuuta 2026. Aiemmin tallennetut tokenit voivat yhä toimia jonkin aikaa, mutta uudet pyynnöt hylätään.

— Qwen Code Docs, Todennus, virallinen dokumentaatio
Toinen vaihtoehto on Alibaba ModelStudion Coding Plan -tilaus. Siinä on kiinteä kuukausimaksu, viikoittainen pyyntökiintiö ja erillinen yhteysosoite. Kolmas vaihtoehto on mallipalveluntarjoajan API-avain. Siinä ei ole kiinteää maksua: lisäät rahaa saldoosi ja käytät sitä työn edetessä tokenmittarin mukaan. Tämä vaihtoehto on joustava ja sopii sinulle, jos käytät agenttia epäsäännöllisesti. Artikkelin loppu käsittelee tätä vaihtoehtoa. ## Mistä voit luoda Qwen Coden API-avaimen?
Tärkein asia Qwen Code voi yhdistää useisiin palveluntarjoajiin ja protokolliin. Valitse suoralle Alibaba Model Studio -yhteydelle alue Model Studio -konsolissa ennen avaimen luomista. Avaimen, API:n perusosoitteen, työtilan ja saatavilla olevan mallin on vastattava tätä aluetta. Kansainvälisen konsolin osoite tai englanninkielinen käyttöliittymä ei yksin määritä API:n aluetta.
Koska Qwen Code ymmärtää eri protokollia, et ole sidottu yhteen avainten tarjoajaan. Virallisessa dokumentaatiossa luetellaan nimenomaisesti palvelut, joihin se voi yhdistää.

Tukee OpenAI-, Anthropic-, Gemini- ja Qwen-protokollia. Mikä tahansa kolmannen osapuolen palveluntarjoaja tai paikallinen malli. Vaihda lennossa.

— Qwen Code Docs, Todennus, virallinen dokumentaatio
Alla kuvataan suora yhteystapa. Avaa suoraa yhteyttä varten [Alibaba Model Studio -konsoli](https://modelstudio.console.alibabacloud.com/), valitse haluttu alue ja luo avain API-avainten hallintasivulla. Säilytä alueen ja työtilan nimi määrityksen yhteydessä; älä kopioi avainta jaettuihin muistiinpanoihin. | Avaimelle valittu alue | Tavallinen OpenAI-yhteensopiva perusosoite | Mitä varmistetaan | |----|----|----| | Kiina (Peking) | `DASHSCOPE_BASE_URL` | Pekingin avain ja kyseisellä alueella saatava malli | | Singapore | `DASHSCOPE_BASE_URL` | Singaporen avain ja kyseisellä alueella saatava malli | | Yhdysvallat (Virginia), myös Global- tai US-käyttöönoton laajuus | Kopioi valitun yhdysvaltalaisen työtilan API Host ja käytä sen dokumentoitua OpenAI-yhteensopivaa perusosoitetta | Yhdysvaltalaisen työtilan avain, käyttöönoton laajuus ja malliluettelo; älä käytä Pekingin tai Singaporen osoitetta | [Alueopas](https://www.alibabacloud.com/help/en/model-studio/regions) suosittelee tuotantoon työtilakohtaisia verkkotunnuksia. Kopioi todellinen API Host kohdasta Workspace Management ja noudata [perusosoiteopasta](https://www.alibabacloud.com/help/en/model-studio/base-url); älä keksi työtilatunnistetta. Nykyiset jaetut DashScope-päätepisteet ja työtilakohtaiset päätepisteet ovat eri käyttöreittejä. Myös Coding Plan ja Token Plan käyttävät omia päätepisteitään ja avaimiaan. Kopioi koko OpenAI-yhteensopiva perusosoite valitun alueellisen työtilan konsolista muuttujaan `DASHSCOPE_BASE_URL`. JSON jättää `baseUrl`-kentän pois; osoite annetaan ennen käynnistystä muuttujalla `OPENAI_BASE_URL`. Käytä konsolin todellisia arvoja, älä työtilan paikkamerkkiä. On myös maksuton vaihtoehto, johon ei tarvita avainta: suorita Qwen-mallia tietokoneellasi Ollaman kautta ja yhdistä Qwen Code siihen omaan palvelimeesi. Tämä vaatii tehokkaan koneen ja erilliset asetukset. Oppaassa [Qwen Coden käynnistäminen terminaalissa](https://ailoot.ai/blog/fi/qwen-code-terminal-auto-edit/) näytetään, miten agenttia käytetään paikallisesti. ## Miten lisäät avaimen Qwen Codeen, jotta se toimii?
Tärkein asia Määritä `~/.qwen/settings.json`-tiedostossa protokolla, alueellinen perusosoite, mallitunniste ja `envKey`, joka on avaimen antavan ympäristömuuttujan nimi. Pidä salainen arvo pois tästä JSONista. Käynnistä Qwen Code siitä päätteestä, jossa muuttuja on asetettu, tarkista valittu yhteys ja lähetä lyhyt kehote ennen määrityksen pitämistä käyttökelpoisena. `/model` luettelee määritetyt valinnat; se ei yksin osoita palveluntarjoajan käyttöoikeutta.
Varmuuskopioi nykyiset asetukset ja yhdistä alla oleva yhteys `~/.qwen/settings.json`-tiedostoon; älä korvaa muita palveluntarjoajia tai asetuksia. Havainnollistava määritys seuraa [Qwen Coden tunnistautumisesimerkkiä](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) siten, että työtilan URL annetaan muuttujalla `OPENAI_BASE_URL`, API-avain luetaan `envKey`-kentän nimeämästä ympäristömuuttujasta ja selväkielinen `env`-lohko jätetään pois. `qwen3-coder-plus` on virallisen esimerkin malli; varmista ensin sen saatavuus valitulla alueella/tilillä tai käytä molemmissa kohdissa alueen konsolista saatua todellista mallitunnistetta. Kopioi koko OpenAI-yhteensopiva perusosoite valitun alueellisen työtilan konsolista muuttujaan `DASHSCOPE_BASE_URL`. JSON jättää `baseUrl`-kentän pois; osoite annetaan ennen käynnistystä muuttujalla `OPENAI_BASE_URL`. Käytä konsolin todellisia arvoja, älä työtilan paikkamerkkiä. ```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` valitsee yhteensopivan protokollan. `envKey` nimeää Qwen Coden lukeman muuttujan; se ei ole avaimen arvo. `model.name`-arvon on vastattava määritettyä `id`-arvoa. [Mallipalveluntarjoajien viite](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/) dokumentoi kentät. Avaa macOS:ssä tai Linuxissa Bash-pääte, anna avain piilotettuun syötteeseen ja käynnistä Qwen Code samassa päätteessä: ```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 ``` Käytä Windowsissa PowerShelliä: ```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 ``` Nämä komennot pitävät salaisen arvon pois JSONista ja komentohistoriasta; käynnissä oleva prosessi saa sen silti ympäristössään. Älä tulosta avainta, tallenna sitä versionhallintaan tai liitä sitä kehotteeseen. Poista vanha salaisuuden sisältävä `env`-merkintä asetuksista käyttäessäsi tätä reittiä. Uudessa päätteessä muuttuja täytyy antaa uudelleen. Tarkista Qwen Codessa tunnistautuminen komennolla `/doctor` ja määritetty valinta komennolla `/model`. Lähetä vaarattomassa tyhjässä testikansiossa: ”Vastaa sanalla connected. Älä lue tai muuta tiedostoja äläkä suorita komentoja.” Onnistunut vastaus testaa yhden mallipyynnön ja voi aiheuttaa käyttömaksuja. Mallin näkyminen `/model`-luettelossa vahvistaa vain paikallisen määrityksen. Jos pyyntö epäonnistuu, säilytä salaisuuksista siistitty virhe ja mahdollinen pyyntötunniste. Tarkista tunnistautuminen erillään mallin saatavuudesta ja laskutuksesta: varmista samassa palveluntarjoajan konsolissa avaimen myöntänyt alusta, alue/työtila, tavallinen tai pakettikohtainen päätepiste, valittu mallitunniste ja tilin saldo/kiintiö. 401 voi johtua avaimen/päätepisteen tai laskutuspaketin ristiriidasta; se ei osoita palveluntarjoajan olevan rikki. Pysähdy epäonnistuneen tarkistuksen jälkeen ja korjaa dokumentoitu ristiriita ennen uutta yritystä. Tämä artikkeli kuvaa dokumentaatioon perustuvaa esimerkkiä, ei opasta varten tehtyä maksullista pyyntöä. ## Paljonko API-avaimella työskentely maksaa ja mikä kasvattaa laskua?
Tärkein asia API-avaimella maksat käytön mukaan: hinta määritellään jokaiselle tuhannelle syöte- ja tulostetokenille, eikä kiinteää kuukausimaksua ole. Kevyemmät mallit, kuten Qwen3-Coder-Flash, maksavat useita kertoja vähemmän. Lasku kasvaa työmäärän mukaan: mitä pidempiä tiedostosi ovat ja mitä enemmän agentti lukee ja kirjoittaa, sitä suurempi käyttö on. Tarkista tarkka hinta aina palveluntarjoajan sivulta; se muuttuu.
Avain eroaa tilauksesta siinä, ettei siihen liity kiinteää kuukausimaksua. Maksat siitä, mitä malli lukee ja kirjoittaa, ja käyttö mitataan tokeneina. Token on tekstinpätkä, joka vastaa suunnilleen muutamaa kirjainta. Jokaisella mallilla on oma hintansa miljoonaa syötetokenia ja miljoonaa tulostetokenia kohden, ja tuloste maksaa lähes aina enemmän kuin syöte. Miljoona tokenia kuulostaa suurelta määrältä, mutta ison projektin parissa se kuluu odotettua nopeammin: agentti lukee tiedostosi kokonaan jokaisen pyynnön yhteydessä. Käytännössä lasku riippuu agentin käsittelemän tekstin määrästä. Pitkät tiedostot, pitkät istunnot ja koodin jatkuva lukeminen uudelleen kuluttavat saldoa nopeimmin; tehtävien määrä on toissijainen. Erillisessä artikkelissa selitetään vaihe vaiheelta, [miten API-tokenien käyttö lasketaan](https://ailoot.ai/blog/fi/api-token-usage-calculation/) ja miksi saldo voi huveta huomaamatta. ## Miksi maksut hylätään?
Tärkein asia Avaimen käytön aloittamiseksi saldoa on täydennettävä. Jos maksujärjestelmä hylkää korttisi sen myöntäneen pankin vuoksi, sähköpostiosoitteen, kielen tai profiiliasetusten vaihtaminen ei muuta kyseisen kortin ehtoja.
Tässä kohtaa tehdään yleinen virhe. Este tulee vastaan seuraavassa vaiheessa. Olet luonut avaimen, mutta ilman rahaa saldolla sillä ei voi käyttää mitään — palveluntarjoaja palauttaa virheen riittämättömistä varoista. Jos hylkäys liittyy kortin myöntäneeseen pankkiin, sähköpostiosoitteen, käyttöliittymän kielen tai profiiliasetusten vaihtaminen ei muuta maksuehtoja. Mekanismia selitetään esimerkillä [ulkomaisesta kortista Claudea varten](https://ailoot.ai/blog/fi/claude-card-payment-requirements/). Muista myös, että maksunvälittäjä tekee lopullisen päätöksen. Se voi hylätä maksun omista syistään, eikä maksun läpimenosta ole takeita. ## Mistä kannattaa aloittaa?
Tärkein asia Aloita erottamalla tunnistautumis- ja laskutusreitit: vanha maksuton Qwen OAuth -taso lopetettiin, Coding Plan käyttää tilausta ja omaa päätepistettä, ja tämä opas käyttää tavallista käytön mukaan laskutettavaa Model Studio API-avainta. Luo avain maksutta valitulla alueella ja työtilassa, määritä asetuksiin sen muuttujan nimi ja anna salaisuus päätteessä. Tarvitset maksunvälittäjän hyväksymän kortin saldon lisäämiseen. Valitse kevyempi malli, jos haluat pitää käytön kurissa.
Lyhyt vaiheittainen suunnitelma: 1. Erota alustasi ja laskutuspakettisi tunnistautumisreitit. Vanha maksuton Qwen OAuth -taso lopetettiin huhtikuussa 2026; Coding Plan ja tavallinen Model Studio API ovat eri laskutusreittejä. Tämä opas käyttää tavallista käytön mukaan laskutettavaa API-avainta. 2. Luo tili palveluntarjoajalle. Yksinkertaisin vaihtoehto on Alibaba suoraan. 3. Luo avain palveluntarjoajan tilin käyttöavainten osiossa. Sen luominen on ilmaista; et tarvitse siihen korttia. 4. Yhdistä alueellinen yhteys `~/.qwen/settings.json`-tiedostoon ilman salaista arvoa. Anna `DASHSCOPE_API_KEY` käynnistävässä päätteessä ja tarkista sitten valittu malli sekä yksi lyhyt vastaus yllä kuvatusti. 5. Käytöstä maksamiseen tarvitset omiin nimiisi myönnetyn kortin, jonka palveluntarjoajan maksunvälittäjä hyväksyy. Maksunvälittäjä määrittää saldon täyttämisen ehdot; avaimen luominen ja käytöstä maksaminen ovat erillisiä vaiheita. Kannattaa myös miettiä, mitä mallia tarvitset. Vaativiin tehtäviin valitse tehokkaampi Qwen3-Coder-Plus; rahaa säästääksesi valitse kevyempi Flash, joka maksaa samalla käyttömäärällä useita kertoja vähemmän. Opas [Qwen Code Claude Coden korvaajana](https://ailoot.ai/blog/fi/qwen-code-token-plan-setup/) näyttää, miten Qwen Code eroaa muista terminaaliagenteista.
### Lähteet - [Qwen Code - GitHub repository](https://github.com/QwenLM/qwen-code) - avoimen lähdekoodin agenttikoodi, asennus, moniprotokollatuki ja yhteydet kolmannen osapuolen palveluntarjoajiin - [Qwen Code - authentication documentation](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) - version mukaiset tunnistautumisvaihtoehdot, maksuttoman OAuthin lopettaminen 15.04.2026 ja yhteyden määritys ilman salaista arvoa - [Alibaba Model Studio — konsoli ja alueen valinta](https://modelstudio.console.alibabacloud.com/) - valitse alue ja työtila ennen avaimen luomista; sovita perusosoite ja malli niihin
Lisää materiaalia on saatavilla [Ailootissa](https://ailoot.ai/). ## Kysymyksiä tästä oppaasta: Tekoäly ja ohjelmointi: Qwen Coden API-avain: mistä sen saa, miten sen yhdistää ja miten käyttö lasketaan ### Onko API-avaimen luominen sama asia kuin mallikäytön ostaminen? Ei. Pääsymerkkijonon luominen ja käytön rahoittaminen ovat eri asioita. Palveluntarjoaja tunnistaa ja mittaa pyynnöt avaimella. Luotu avain ei yksin osoita tilillä olevan käytettävää saldoa tai kiintiötä. ### Minkä pitää täsmätä Qwen Coden palveluntarjoajamäärityksessä? Valitun protokollan, palveluntarjoajan perusosoitteen, avaimen sisältävän ympäristömuuttujan ja mallitunnisteen pitää koskea samaa yhteyttä. Esimerkissä model.name vastaa modelProviders-rivin id-arvoa. Pidä oikea avain pois jaetuista asetuskopioista. ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.