# Kunci API Qwen Code: Di Mana Mendapatkannya, Cara Menghubungkannya, dan Menghitung Penggunaan

> Apa itu kunci API Qwen Code, apa bedanya dengan langganan, di mana mendapatkannya, cara mengonfigurasi settings.json, dan apa yang menentukan penggunaan token.

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


Seseorang memasang Qwen Code, meluncurkannya di terminal, lalu pada permintaan pertama muncul permintaan kunci. Kemudian pencarian pun dimulai: orang mengetik “buy api key for qwen code” dan mendarat di halaman yang menjual langganan atau akses siap pakai milik orang lain. Berikut penjelasan tentang kunci tersebut, di mana mendapatkannya, dan berapa biayanya, langkah demi langkah.

Inti utamanya: tidak ada yang menjual kunci API sebagai produk terpisah dalam kemasan. Kunci itu adalah rangkaian akses yang Anda terbitkan sendiri di akun penyedia model, dan penerbitannya gratis. Anda baru memerlukan uang nanti, saat mengisi saldo; ketentuan penyedia berlaku pada tahap itu. Di bawah ini: di mana mendapatkan kunci, cara menghubungkannya ke Qwen Code, dan biaya penggunaannya.

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

Perhatian

Materi ini bersifat informatif dan menjelaskan aturan publik. Materi ini tidak menyebut layanan perantara yang menawarkan untuk “mengurus” pembayaran dengan menghindari pembatasan, atau menjelaskan cara menghindari pembatasan. Harga diambil dari halaman penyedia per awal September 2026; harga dapat berubah, jadi periksa situs penyedia untuk harga terkini.

</div>

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

[Dokumentasi Ailoot](https://ailoot.ai/docs/) — bahan referensi tentang penggunaan layanan.

</div>

## Apa sebenarnya kunci API untuk Qwen Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Kunci API untuk Qwen Code adalah rangkaian pribadi seperti kata sandi yang digunakan penyedia layanan untuk mengenali permintaan Anda ke model dan menghitung penggunaannya. Qwen Code sendiri adalah agen sumber terbuka gratis; program ini tidak memiliki model bawaan. Qwen Code menerima jawaban dari penyedia eksternal dan menyampaikan kunci Anda kepada penyedia tersebut. Jadi, “mendapatkan kunci” berarti mendaftar ke penyedia dan menerbitkan rangkaian akses di akunnya. Pasok nilai kunci melalui variabel lingkungan terminal peluncur dan tentukan hanya nama variabel `envKey` dalam JSON. Sebelum menggunakannya, periksa koneksi serta jawaban nyata sesuai langkah di bawah; permintaan yang berhasil dapat menimbulkan biaya.

</div>

Qwen Code adalah agen AI sumber terbuka yang berjalan di terminal dan menulis kode untuk tugas Anda. Agen ini gratis, dipasang melalui npm, dan tidak memiliki jaringan saraf sendiri di dalamnya. Model yang melakukan seluruh pekerjaan cerdas, dan model berjalan di server penyedia.

Qwen Code memerlukan izin untuk mengakses model. Izin itu adalah kunci API—rangkaian panjang seperti kata sandi yang diterbitkan penyedia secara pribadi kepada Anda. Saat agen mengirim permintaan, agen menyertakan kunci tersebut; penyedia menggunakannya untuk mengenali pemilik permintaan, memberikan jawaban, dan memotong penggunaan dari saldo Anda.

Ini mengarah pada poin sederhana yang meluruskan separuh kebingungan. Kunci tidak dibeli sebagai produk marketplace: Anda membuat akun di penyedia, mengeklik “buat kunci”, dan mendapatkan rangkaian itu secara gratis. Pencarian “buy api key” sebenarnya berarti “di mana saya membuat akun dan bagaimana saya membayar penggunaan setelahnya,” dan kedua pertanyaan itu dibahas di bawah.

## Apa perbedaan kunci API dengan langganan dan login gratis yang lama?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Qwen Code mendukung beberapa jalur autentikasi dan penagihan. Tingkat gratis Qwen OAuth lama dihentikan pada 15 April 2026. Alibaba Coding Plan menggunakan langganan dan endpoint khusus; kunci API Model Studio standar menggunakan penagihan sesuai pemakaian. Klien saat ini juga menawarkan platform dan paket lain. Panduan ini membahas jalur kunci API Model Studio standar: pertahankan kecocokan wilayah, endpoint, model, dan paket penagihannya.

</div>

Di dalam Qwen Code, `/auth` menampilkan pilihan autentikasi yang didukung versi terpasang. Pilih entri untuk platform penerbit kunci dan paket penagihannya. Perbedaan di bawah menjelaskan login gratis lama, Coding Plan, serta kunci API standar yang digunakan panduan ini; ini bukan daftar lengkap entri menu saat ini.

Opsi pertama adalah login gratis melalui akun Qwen (Qwen OAuth). Dahulu opsi ini memberikan akses ke model tanpa kunci, tetapi layanan tersebut telah dihentikan.

<figure>
<blockquote>
<p>Tingkat gratis Qwen OAuth dihentikan mulai 15 April 2026. Token yang sebelumnya disimpan mungkin masih berfungsi untuk sementara, tetapi permintaan baru akan ditolak.</p>
</blockquote>
<figcaption>— Dokumentasi Qwen Code, Autentikasi, dokumentasi resmi</figcaption>
</figure>

Opsi kedua adalah langganan Coding Plan dari Alibaba ModelStudio. Biayanya tetap per bulan, memberikan kuota permintaan mingguan, dan menggunakan alamat koneksi terpisah.

Opsi ketiga adalah kunci API dari penyedia model. Tidak ada biaya tetap: Anda mengisi saldo dan menggunakannya saat bekerja, berdasarkan hitungan token. Opsi ini fleksibel dan cocok jika Anda menggunakan agen secara tidak teratur. Sisa artikel ini membahas opsi tersebut.

## Di mana Anda dapat menerbitkan kunci API untuk Qwen Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Qwen Code dapat terhubung ke beberapa penyedia dan protokol. Untuk koneksi langsung Alibaba Model Studio, pilih wilayah dalam konsol Model Studio sebelum membuat kunci. Kunci, API base URL, ruang kerja, dan model yang tersedia harus cocok dengan wilayah itu. Alamat konsol internasional atau antarmuka berbahasa Inggris tidak dengan sendirinya menunjukkan wilayah API.

</div>

Karena Qwen Code memahami berbagai protokol, Anda tidak terbatas pada satu penyedia kunci saja. Dokumentasi resminya secara eksplisit mencantumkan layanan yang dapat dihubungkannya.

<figure>
<blockquote>
<p>Mendukung protokol OpenAI, Anthropic, Gemini, dan Qwen. Penyedia pihak ketiga atau model lokal apa pun. Beralih kapan saja.</p>
</blockquote>
<figcaption>— Dokumentasi Qwen Code, Autentikasi, dokumentasi resmi</figcaption>
</figure>

Di bawah ini adalah jalur koneksi langsung.

Untuk jalur langsung, buka [konsol Alibaba Model Studio](https://modelstudio.console.alibabacloud.com/), pilih wilayah yang dituju, lalu buat kunci pada halaman pengelolaan kunci API. Simpan wilayah dan nama ruang kerja bersama konfigurasi; jangan salin kunci ke catatan bersama.

| Wilayah yang dipilih untuk kunci | OpenAI-compatible base URL standar | Yang perlu diverifikasi |
|----|----|----|
| Tiongkok (Beijing) | `DASHSCOPE_BASE_URL` | Kunci Beijing dan model yang tersedia di wilayah tersebut |
| Singapura | `DASHSCOPE_BASE_URL` | Kunci Singapura dan model yang tersedia di wilayah tersebut |
| AS (Virginia), termasuk cakupan deployment Global atau US | Salin API Host ruang kerja AS terpilih dan gunakan OpenAI-compatible base URL yang didokumentasikan | Kunci ruang kerja AS, cakupan deployment, serta daftar model; jangan gunakan kembali alamat Beijing atau Singapura |

[Panduan wilayah](https://www.alibabacloud.com/help/en/model-studio/regions) menyarankan domain khusus ruang kerja untuk produksi. Salin API Host sebenarnya dari Workspace Management dan ikuti [panduan base URL](https://www.alibabacloud.com/help/en/model-studio/base-url); jangan mengarang ID ruang kerja. Endpoint DashScope bersama dan endpoint khusus ruang kerja merupakan pilihan akses berbeda. Coding Plan dan Token Plan juga menggunakan endpoint serta kunci masing-masing. Salin Base URL lengkap yang kompatibel dengan OpenAI dari konsol ruang kerja pada wilayah terpilih ke `DASHSCOPE_BASE_URL`. JSON tidak memuat `baseUrl`; alamat dipasok melalui `OPENAI_BASE_URL` sebelum peluncuran. Gunakan nilai sebenarnya dari konsol, bukan penanda ID ruang kerja.

Ada juga opsi gratis yang tidak memerlukan kunci: jalankan model Qwen di komputer Anda melalui Ollama dan hubungkan Qwen Code ke model itu sebagai server Anda sendiri. Opsi ini memerlukan komputer yang kuat dan penyiapan terpisah. Cara menjalankan agen secara lokal ditunjukkan dalam panduan [meluncurkan Qwen Code di terminal](https://ailoot.ai/blog/id/qwen-code-terminal-auto-edit/).



## Bagaimana cara menambahkan kunci ke Qwen Code agar berfungsi?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Dalam `~/.qwen/settings.json`, konfigurasikan protokol, base URL regional, ID model, serta `envKey`, yaitu nama variabel lingkungan yang memasok kunci. Jauhkan nilai rahasia dari JSON ini. Jalankan Qwen Code dari terminal yang memiliki variabel tersebut, periksa koneksi terpilih, lalu kirim satu prompt pendek sebelum menganggap penyiapan dapat digunakan. `/model` mendaftar pilihan terkonfigurasi; itu sendiri tidak membuktikan akses penyedia.

</div>

Cadangkan pengaturan yang ada lalu gabungkan koneksi berikut ke `~/.qwen/settings.json`; jangan menimpa penyedia atau preferensi lain. Konfigurasi ilustratif ini mengikuti [contoh autentikasi Qwen Code](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) dengan URL workspace melalui `OPENAI_BASE_URL`, kunci API dibaca dari variabel lingkungan yang disebut oleh `envKey`, dan tanpa blok `env` berisi rahasia teks biasa. `qwen3-coder-plus` adalah model dalam contoh resmi; terlebih dahulu pastikan wilayah/akun terpilih menyediakannya, atau gunakan ID model sebenarnya dari konsol wilayah itu di kedua tempat.

Salin Base URL lengkap yang kompatibel dengan OpenAI dari konsol ruang kerja pada wilayah terpilih ke `DASHSCOPE_BASE_URL`. JSON tidak memuat `baseUrl`; alamat dipasok melalui `OPENAI_BASE_URL` sebelum peluncuran. Gunakan nilai sebenarnya dari konsol, bukan penanda ID ruang kerja.

```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` memilih protokol yang kompatibel. `envKey` menamai variabel yang dibaca Qwen Code; itu bukan nilai kunci. `model.name` harus cocok dengan `id` terkonfigurasi. [Referensi penyedia model](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/model-providers/) mendokumentasikan kolom tersebut.

Di macOS atau Linux, buka terminal Bash dan masukkan kunci pada prompt tersembunyi, lalu jalankan Qwen Code dalam terminal yang sama:

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

Di Windows, gunakan 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
```

Perintah ini menjaga rahasia literal keluar dari JSON dan riwayat perintah shell; proses yang berjalan tetap menerimanya di lingkungan. Jangan mencetak, melakukan commit, atau menempelkannya ke prompt. Hapus entri `env` lama yang berisi rahasia dari pengaturan saat menerapkan jalur ini. Terminal baru membutuhkan variabel tersebut dipasok kembali.

Dalam Qwen Code, gunakan `/doctor` untuk memeriksa autentikasi dan `/model` untuk memeriksa pilihan terkonfigurasi. Dalam folder uji kosong yang aman, kirim: “Reply with the word connected. Do not read or change files or run commands.” Jawaban berhasil menguji satu permintaan model dan dapat menimbulkan biaya penggunaan. Model yang muncul di `/model` hanya mengonfirmasi konfigurasi lokal.

Jika permintaan gagal, catat galat yang sudah disunting agar rahasia tidak terlihat dan ID permintaan bila diberikan. Periksa autentikasi secara terpisah dari ketersediaan model dan penagihan: verifikasi platform penerbit kunci, wilayah/ruang kerja, endpoint standar atau paket, ID model terpilih, serta saldo/kuota pada konsol penyedia yang sama. Kode 401 dapat mencerminkan ketidakcocokan kunci/endpoint atau paket penagihan; itu bukan bukti penyedia rusak. Berhenti setelah pemeriksaan gagal dan perbaiki ketidakcocokan yang didokumentasikan sebelum mencoba lagi. Artikel ini menjelaskan contoh berdasarkan dokumentasi, bukan permintaan berbayar yang dilakukan untuk panduan ini.

## Berapa biaya penggunaan kunci API, dan apa yang membuat tagihan bertambah?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Dengan kunci API, Anda membayar berdasarkan pemakaian: ada harga untuk setiap seribu token input dan output, tanpa biaya bulanan tetap. Model yang lebih ringan, seperti Qwen3-Coder-Flash, harganya beberapa kali lebih murah. Tagihan bertambah sesuai banyaknya pekerjaan: semakin panjang file Anda dan semakin banyak yang dibaca dan ditulis agen, semakin tinggi penggunaannya. Selalu periksa halaman penyedia untuk harga yang tepat; harga dapat berubah.

</div>

Perbedaan kunci dengan langganan adalah tidak ada biaya bulanan tetap. Anda membayar berdasarkan apa yang dibaca dan ditulis model, yang diukur dalam token. Token adalah potongan teks yang kira-kira panjangnya beberapa huruf. Setiap model memiliki harga tersendiri per juta token input dan per juta token output, dengan biaya output hampir selalu lebih tinggi daripada input.

Satu juta token terdengar banyak, tetapi saat mengerjakan proyek besar, jumlah itu habis lebih cepat dari perkiraan: agen membaca seluruh file Anda pada setiap permintaan.

Kesimpulan praktisnya: tagihan bergantung pada jumlah teks yang diproses agen. File yang panjang, sesi yang panjang, dan membaca ulang kode terus-menerus paling cepat menghabiskan saldo Anda; jumlah tugas berada di urutan kedua. Artikel terpisah menjelaskan langkah demi langkah [cara menghitung penggunaan token API](https://ailoot.ai/blog/id/api-token-usage-calculation/) dan alasan saldo dapat terkuras tanpa disadari.

## Mengapa pembayaran ditolak?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Untuk mulai menggunakan saldo dari kunci, Anda perlu mengisi saldo. Jika sistem pembayaran menolak kartu Anda karena bank penerbitnya, mengganti email, bahasa, atau pengaturan profil tidak mengubah ketentuan kartu tersebut.

</div>

Di sinilah kesalahan umum terjadi.

Kendalanya muncul satu langkah kemudian. Anda sudah menerbitkan kunci, tetapi tanpa uang di saldo, kunci itu tidak dapat digunakan—penyedia akan mengembalikan kesalahan insufficient funds.

Jika penolakan terkait dengan bank yang menerbitkan kartu, mengganti email, bahasa antarmuka, atau pengaturan profil tidak mengubah ketentuan pembayaran. Mekanisme ini dijelaskan dengan contoh [kartu asing untuk Claude](https://ailoot.ai/blog/id/claude-card-payment-requirements/).

Perlu diingat bahwa gerbang pembayaran yang membuat keputusan akhir. Gerbang tersebut dapat menolak pembayaran karena alasannya sendiri, dan tidak ada jaminan pembayaran akan berhasil.

## Dari mana sebaiknya Anda mulai?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Poin utama">

Poin utama

Bedakan autentikasi dan penagihan menurut platform serta paket terpilih; tiga contoh ini bukan seluruh menu. Tingkat Qwen OAuth gratis lama telah dihentikan, Coding Plan memakai langganan dan endpoint khusus, sedangkan panduan ini memakai kunci API Model Studio standar sesuai pemakaian. Terbitkan kunci di wilayah/ruang kerja terpilih, atur koneksi tanpa rahasia dalam JSON, dan pasok kunci melalui lingkungan terminal peluncur. Anda memerlukan kartu yang diterima gerbang pembayaran untuk mengisi saldo. Pilih model lebih ringan jika ingin menekan penggunaan.

</div>

Rencana singkat langkah demi langkah:

1.  Periksa platform dan paket dalam menu versi terpasang. Tingkat Qwen OAuth gratis lama dihentikan pada April 2026; Coding Plan memakai langganan dan endpoint khusus. Panduan ini memakai kunci API standar sesuai pemakaian, bukan daftar seluruh menu.
2.  Buat akun di penyedia. Opsi paling sederhana adalah Alibaba secara langsung.
3.  Terbitkan kunci di akun penyedia, pada bagian kunci akses. Penerbitannya gratis; Anda tidak memerlukan kartu untuk itu.
4.  Gabungkan koneksi regional ke `~/.qwen/settings.json` tanpa nilai rahasia. Pasok `DASHSCOPE_API_KEY` dalam terminal peluncur, lalu periksa model terpilih serta satu jawaban pendek seperti di atas.
5.  Untuk membayar penggunaan, Anda memerlukan kartu yang diterbitkan atas nama Anda dan diterima oleh gerbang pembayaran penyedia. Gerbang pembayaran menentukan ketentuan pengisian saldo; penerbitan kunci dan pembayaran penggunaan adalah dua langkah terpisah.

Sebaiknya pertimbangkan juga model yang Anda perlukan. Untuk tugas berat, pilih Qwen3-Coder-Plus kelas atas; untuk menghemat uang, pilih Flash yang lebih ringan dan beberapa kali lebih murah untuk volume yang sama. Panduan [Qwen Code sebagai pengganti Claude Code](https://ailoot.ai/blog/id/qwen-code-token-plan-setup/) menunjukkan perbedaan Qwen Code dengan agen terminal lainnya.

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

### Sumber

- [Qwen Code - repositori GitHub](https://github.com/QwenLM/qwen-code) - kode agen sumber terbuka, instalasi, dukungan multi-protokol, dan koneksi ke penyedia pihak ketiga
- [Qwen Code - dokumentasi autentikasi](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) - pilihan autentikasi, penghentian tingkat OAuth gratis pada 15.04.2026, dan konfigurasi koneksi kunci API standar
- [Alibaba Model Studio - konsol](https://modelstudio.console.alibabacloud.com/) - pilih wilayah/ruang kerja sebelum membuat kunci dan cocokkan endpoint serta daftar model

</div>



Materi lainnya tersedia di [Ailoot](https://ailoot.ai/).

## Pertanyaan tentang Kunci API Qwen Code: Di Mana Mendapatkannya, Cara Menghubungkannya, dan Menghitung Penggunaan

### Apakah menerbitkan kunci API sama dengan membeli penggunaan model?

Tidak. Menerbitkan string akses terpisah dari mendanai penggunaan. Penyedia mengidentifikasi dan mengukur permintaan melalui kunci; kunci yang diterbitkan saja tidak membuktikan akun memiliki saldo atau kuota yang dapat digunakan.

### Apa yang harus cocok dalam konfigurasi penyedia Qwen Code?

Protokol terpilih, base URL penyedia, variabel lingkungan yang memuat kunci, dan identitas model harus mengacu pada koneksi yang sama. Dalam contoh, model.name cocok dengan id pada entri modelProviders; jangan sertakan kunci asli dalam salinan pengaturan yang dibagikan.


## Ailoot · Perusahaan dan portofolio proyeknya

Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan.

Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.

Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.