Kunci API Qwen Code: tempat mendapatkannya, cara menyambungkannya dan mengira penggunaan

Seseorang memasang Qwen Code, melancarkannya di terminal, dan pada permintaan pertama, ia meminta kunci. Kemudian bermulalah pencarian: orang menaip “buy api key for qwen code” lalu tiba di halaman yang menjual sama ada langganan atau akses sedia guna milik orang lain. Berikut ialah maksud kunci itu, tempat mendapatkannya dan kosnya, langkah demi langkah.

Perkara utama terlebih dahulu: kunci API tidak dijual sebagai produk berasingan yang siap dibungkus. Kunci ialah rentetan akses yang anda keluarkan sendiri dalam akaun penyedia model, dan pengeluarannya percuma. Anda hanya memerlukan wang kemudian, apabila menambah nilai baki; syarat penyedia terpakai pada langkah itu. Di bawah: tempat mendapatkan kunci, cara menyambungkannya kepada Qwen Code dan kos penggunaannya.

Apakah sebenarnya kunci API untuk Qwen Code?#

Qwen Code ialah ejen AI sumber terbuka yang berjalan di terminal dan menulis kod untuk tugasan anda. Ia percuma, dipasang melalui npm dan tidak mempunyai rangkaian neural sendiri di dalamnya. Model melakukan semua kerja pintar, dan model itu berjalan pada pelayan penyedia.

Qwen Code memerlukan pas untuk mengakses model. Pas itu ialah kunci API—rentetan panjang seperti kata laluan yang dikeluarkan oleh penyedia khusus untuk anda. Apabila ejen menghantar permintaan, ia menyertakan kunci itu; penyedia menggunakannya untuk mengenal pasti pemilik permintaan, memberikan respons dan menolak penggunaan daripada baki anda.

Ini membawa kepada satu perkara mudah yang menjelaskan separuh daripada kekeliruan. Kunci tidak dibeli sebagai produk pasaran: anda mencipta akaun dengan penyedia, mengklik “create key” dan menerima rentetan itu secara percuma. Carian “buy api key” sebenarnya bermaksud “di manakah saya boleh mencipta akaun dan bagaimana saya membayar penggunaan selepas itu”, dan kedua-dua soalan ini dijawab di bawah.

Apakah perbezaan kunci API dengan langganan dan log masuk percuma yang lama?#

Dalam Qwen Code, /auth memaparkan pilihan pengesahan yang disokong oleh versi terpasang anda. Pilih entri untuk platform yang mengeluarkan kunci anda serta pelan pengebilannya. Perbezaan di bawah menerangkan log masuk percuma lama, Coding Plan dan kunci API standard yang digunakan di sini; ia bukan senarai lengkap semua entri menu semasa.

Pilihan pertama ialah log masuk percuma melalui akaun Qwen (Qwen OAuth). Dahulu, pilihan ini memberikan akses kepada model tanpa sebarang kunci, tetapi ia telah dihentikan.

Pilihan kedua ialah langganan Coding Plan Alibaba ModelStudio. Ia mengenakan bayaran bulanan tetap yang memberikan anda kuota permintaan mingguan dan alamat sambungan berasingan.

Pilihan ketiga ialah kunci API daripada penyedia model. Tiada bayaran tetap: anda menambah nilai baki dan menggunakannya semasa bekerja, berdasarkan meter token. Pilihan ini fleksibel dan sesuai jika anda menggunakan ejen secara tidak tetap. Selebihnya artikel ini memfokuskannya.

Di manakah anda boleh mendapatkan kunci API untuk Qwen Code?#

Oleh sebab Qwen Code memahami pelbagai protokol, anda tidak terhad kepada satu penyedia kunci sahaja. Dokumentasi rasmi menyenaraikan secara jelas perkhidmatan yang boleh disambungkannya.

Di bawah ialah laluan sambungan terus.

Untuk laluan terus, buka konsol Alibaba Model Studio, pilih rantau yang dikehendaki dan cipta kunci melalui halaman pengurusan kunci API. Simpan nama rantau dan ruang kerja bersama konfigurasi; jangan salin kunci ke nota yang dikongsi.

Panduan rantau mengesyorkan domain khusus ruang kerja untuk pengeluaran. Salin API Host sebenar daripada Workspace Management dan ikuti panduan URL asas; jangan reka ID ruang kerja. Endpoint DashScope kongsi sedia ada dan endpoint khusus ruang kerja ialah pilihan akses yang berbeza. Coding Plan dan Token Plan turut mempunyai endpoint serta kunci tersendiri. Salin URL asas penuh yang serasi dengan OpenAI daripada konsol ruang kerja di rantau pilihan ke DASHSCOPE_BASE_URL. JSON tidak menyertakan baseUrl; alamat dibekalkan melalui OPENAI_BASE_URL sebelum pelancaran. Gunakan nilai sebenar konsol, bukan pemegang tempat ID ruang kerja.

Terdapat juga pilihan percuma yang tidak memerlukan sebarang kunci: jalankan model Qwen pada komputer anda melalui Ollama dan sambungkan Qwen Code kepadanya sebagai pelayan anda sendiri. Pilihan ini memerlukan mesin yang berkuasa dan persediaan berasingan. Panduan tentang melancarkan Qwen Code di terminal menunjukkan cara menjalankan ejen secara setempat.

Bagaimanakah cara menambah kunci pada Qwen Code supaya ia berfungsi?#

Sandarkan tetapan sedia ada dan gabungkan sambungan di bawah ke ~/.qwen/settings.json; jangan tindih penyedia atau pilihan lain. Konfigurasi contoh ini mengikuti contoh pengesahan Qwen Code dengan URL ruang kerja melalui OPENAI_BASE_URL, kunci API dibaca daripada pemboleh ubah persekitaran yang dinamakan oleh envKey, dan tanpa blok env yang menyimpan rahsia teks biasa. qwen3-coder-plus ialah model dalam contoh rasmi itu; sahkan dahulu rantau/akaun anda menawarkannya, atau gunakan ID model sebenar daripada konsol rantau itu di kedua-dua tempat.

Salin URL asas penuh yang serasi dengan OpenAI daripada konsol ruang kerja di rantau pilihan ke DASHSCOPE_BASE_URL. JSON tidak menyertakan baseUrl; alamat dibekalkan melalui OPENAI_BASE_URL sebelum pelancaran. Gunakan nilai sebenar konsol, bukan pemegang tempat ID ruang kerja.

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

openai memilih protokol serasi. envKey menamakan pemboleh ubah yang dibaca Qwen Code; ia bukan nilai kunci. model.name mesti sepadan dengan id yang dikonfigurasikan. Rujukan penyedia model mendokumenkan medan ini.

Pada macOS atau Linux, buka terminal Bash, masukkan kunci pada prompt tersembunyi, kemudian lancarkan Qwen Code dalam terminal yang sama:

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

Pada Windows, gunakan 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

Arahan ini mengelakkan nilai rahsia berada dalam JSON dan sejarah arahan shell; proses yang berjalan masih menerimanya melalui persekitaran. Jangan cetak, komit atau tampal kunci ke prompt. Buang entri env lama yang mengandungi rahsia apabila menggunakan laluan ini. Terminal baharu memerlukan pemboleh ubah dibekalkan semula.

Dalam Qwen Code, gunakan /doctor untuk memeriksa pengesahan dan /model untuk menyemak pilihan yang dikonfigurasikan. Dalam folder ujian kosong yang tidak sensitif, hantar: “Balas dengan perkataan connected. Jangan baca atau ubah fail atau jalankan arahan.” Balasan berjaya menguji satu permintaan model dan boleh dikenakan caj penggunaan. Model yang muncul dalam /model hanya mengesahkan konfigurasi setempat.

Jika permintaan gagal, simpan ralat yang telah disunting untuk membuang rahsia dan ID permintaan jika dibekalkan. Semak pengesahan berasingan daripada ketersediaan model dan pengebilan: sahkan platform pengeluar kunci, rantau/ruang kerja, endpoint standard atau pelan, ID model dipilih dan baki/kuota dalam konsol penyedia yang sama. Ralat 401 boleh mencerminkan ketidakpadanan kunci/endpoint atau pelan pengebilan; ia tidak membuktikan penyedia rosak. Berhenti selepas semakan gagal dan betulkan ketidakpadanan yang didokumenkan sebelum mencuba lagi. Artikel ini menerangkan contoh berdasarkan dokumentasi, bukan permintaan berbayar yang dilaksanakan untuk panduan ini.

Berapakah kos menggunakan kunci API dan apakah yang menyebabkan bil meningkat?#

Kunci berbeza daripada langganan kerana tiada jumlah bulanan tetap. Anda membayar berdasarkan perkara yang dibaca dan ditulis oleh model, yang diukur dalam token. Token ialah cebisan teks yang panjangnya kira-kira beberapa huruf. Setiap model mempunyai harga tersendiri bagi setiap juta token input dan setiap juta token output, dan output hampir selalu lebih mahal daripada input.

Sejuta token kedengaran banyak, tetapi apabila anda bekerja pada projek besar, jumlah itu habis lebih cepat daripada jangkaan: ejen membaca keseluruhan fail anda pada setiap permintaan.

Kesimpulan praktikalnya begini. Bil bergantung pada jumlah teks yang diproses oleh ejen. Fail yang panjang, sesi yang panjang dan pembacaan semula kod yang berterusan paling cepat menghabiskan baki anda; bilangan tugasan tidak begitu penting. Artikel berasingan menerangkan langkah demi langkah cara pengiraan penggunaan token API dan sebab baki boleh susut tanpa disedari.

Mengapakah pembayaran ditolak?#

Di sinilah kesilapan biasa berlaku.

Halangan muncul pada langkah seterusnya. Anda sudah mengeluarkan kunci, tetapi tanpa wang dalam baki, kunci itu tidak akan membiayai sebarang penggunaan—penyedia akan memulangkan ralat dana tidak mencukupi.

Jika penolakan itu berkaitan dengan bank yang mengeluarkan kad, menukar e-mel, bahasa antara muka atau tetapan profil tidak mengubah syarat pembayaran. Mekanisme ini diterangkan menggunakan contoh kad asing untuk Claude.

Perlu diingat bahawa keputusan muktamad dibuat oleh gerbang pembayaran. Gerbang itu boleh menolak pembayaran atas sebabnya sendiri dan tiada jaminan pembayaran akan berjaya.

Di manakah patut anda bermula?#

Pelan ringkas langkah demi langkah:

1. Bezakan laluan pengesahan bagi platform dan pelan anda. Tahap Qwen OAuth percuma lama dihentikan pada April 2026; Coding Plan dan API Model Studio standard ialah laluan pengebilan berbeza. Panduan ini menggunakan kunci API standard mengikut penggunaan.
2. Cipta akaun dengan penyedia. Pilihan yang paling mudah ialah Alibaba secara langsung.
3. Keluarkan kunci dalam akaun penyedia, di bahagian kunci akses. Pengeluarannya percuma; anda tidak memerlukan kad untuk itu.
4. Gabungkan sambungan serantau ke ~/.qwen/settings.json tanpa nilai rahsia. Bekalkan DASHSCOPE_API_KEY dalam terminal pelancar, kemudian semak model dipilih dan satu balasan ringkas seperti di atas.
5. Untuk membayar penggunaan, anda memerlukan kad yang dikeluarkan atas nama anda dan diterima oleh gerbang pembayaran penyedia. Gerbang pembayaran menentukan syarat tambah nilai; pengeluaran kunci dan pembayaran untuk penggunaan ialah dua langkah yang berasingan.

Pertimbangkan juga model yang anda perlukan. Untuk tugasan yang mencabar, pilih Qwen3-Coder-Plus yang lebih canggih; untuk berjimat, pilih Flash yang lebih ringan dan beberapa kali lebih murah bagi jumlah penggunaan yang sama. Panduan tentang Qwen Code sebagai pengganti Claude Code menunjukkan perbezaan Qwen Code dengan ejen terminal lain.

Bahan lain boleh didapati di Ailoot.