Mengatur API key kustom di Cline

Cline adalah klien pengkodean. Penyedia API memasok model, mengautentikasi permintaan, dan menagih token. Kunci API khusus menghubungkan kedua lapisan tersebut; itu tidak membuat penggunaan model menjadi gratis dan tidak mengabaikan aturan akses penyedia.

Pengaturan kompatibel OpenAI resmi Cline memperlihatkan bidang yang diperlukan untuk koneksi ini: Penyedia API, Base URL, Kunci API, dan Model ID. Dengan OmniaKey, satu kunci dapat menjangkau Claude, GPT, Gemini, DeepSeek, dan model lain yang didukung melalui antarmuka tersebut.

Cline pengaturan kunci API kustom

Buka Cline di VS Code, pilih ikon pengaturan, lalu masukkan:

Akhiran /v1 adalah bagian dari Base URL yang kompatibel dengan OpenAI. Jangan gunakan asal di sini, dan jangan tambahkan /chat/completions; Cline membangun jalur permintaan.

Konfigurasikan Cline langkah demi langkah

1. Buat kunci API terpisah

Masuk ke OmniaKey, danai saldo prabayar, dan buat kunci API. Kunci terpisah untuk Cline membuat pembatasan, rotasi, dan peninjauan penggunaan lebih mudah daripada berbagi satu kredensial di setiap alat.

Jangan pernah memasukkan kunci literal ke dalam kode sumber, file repositori, masalah, atau tangkapan layar. Tempelkan hanya ke bidang Kunci API Cline.

2. Pilih Kompatibel dengan OpenAI

Buka pengaturan Cline dan pilih OpenAI Compatible di bawah Penyedia API. Jangan memilih penyedia resmi OpenAI ketika kunci milik penyedia lain: pilihan penyedia menentukan bidang konfigurasi dan titik akhir mana yang digunakan Cline.

3. Masukkan Base URL

Gunakan dengan tepat:

https://api.omniakey.com/v1

Nilai salah yang umum mencakup https://api.omniakey.com, /v1/v1 yang diduplikasi, dan jalur permintaan /v1/chat/completions lengkap.

4. Masukkan Model ID yang tepat

Mulailah dengan satu model yang saat ini tercantum dalam katalog model OmniaKey:

Contoh-contoh ini bukanlah alias. Akhiran huruf besar/kecil, tanda baca, dan versi penting. Salin ID daripada mengetik ulang dari memori.

5. Verifikasi sebelum menetapkan tugas sebenarnya

Gunakan kontrol Verifikasi Cline jika ditampilkan untuk penyedia yang dipilih. Kemudian jalankan tugas yang sempit dan dapat dibalik:

Read package.json and name the package manager. Do not edit files.

Verifikasi yang berguna menetapkan empat hal:

1. Cline menerima pengaturan penyedia khusus.
2. Penyedia menerima kunci API.
3. Model persisnya ada untuk kunci tersebut.
4. Satu respons model sederhana muncul tanpa pengeditan atau perulangan alat.

Baru kemudian pindah ke tugas mengubah repositori. Ikhtisar penyiapan agen pengkodean mencakup alur kerja yang lebih luas.

Cara kerja penagihan Cline BYOK

BYOK artinya membawa kunci sendiri. Cline mengirimkan permintaan menggunakan pengaturan penyedia yang Anda berikan, dan penyedia mengenakan biaya penggunaan model sesuai dengan akun tersebut. Cline tidak mengubah API berbayar menjadi penggunaan gratis.

Tinjau input aktual, input cache, dan token output daripada memperkirakan dari jawaban yang terlihat. Pekerjaan agen mencakup konteks repositori, panggilan alat, percobaan ulang, dan penalaran perantara. panduan penagihan transparan menjelaskan mengapa biaya tugas yang diselesaikan lebih berguna dibandingkan tarif satu token utama.

Jika pilihan model masih terbuka, bandingkan kelompok model dalam panduan model agen pengkodean sebelum mengoptimalkan konfigurasi Cline.

Memecahkan masalah kunci Cline API yang tidak berfungsi

Kunci API atau HTTP 401 tidak valid

401 berarti titik akhir tidak menerima kredensial yang diberikan bersama permintaan.

Periksa bahwa:

• kuncinya berasal dari penyedia yang sama dengan Base URL;
• tidak ada spasi awal atau akhir yang ditempel;
• kuncinya aktif dan belum diputar atau dihapus;
• akun tersebut memiliki saldo yang dapat digunakan;
• Cline masih disetel ke OpenAI Compatible.

Membuat ID model baru tidak memperbaiki kegagalan otentikasi.

Model Tidak Ditemukan atau HTTP 404

404 dapat berarti Base URL salah atau Model ID tidak tersedia. Pertama konfirmasikan Base URL berakhir satu kali di /v1. Kemudian salin ID model persisnya dari katalog.

Jika titik akhir berfungsi dengan satu model yang terdaftar namun tidak dengan model lain, koneksi valid dan masalah yang tersisa adalah ketersediaan atau penamaan model.

Kesalahan koneksi

Konfirmasikan bahwa https://api.omniakey.com/v1 dapat dijangkau dari mesin yang sama yang menjalankan Cline. VPN, proksi, DNS, inspeksi TLS, dan aturan firewall dapat memengaruhi IDE bahkan saat halaman browser dimuat di tempat lain.

Jangan nonaktifkan verifikasi TLS untuk menyembunyikan kesalahan sertifikat. Perbaiki konfigurasi jaringan atau kepercayaan.

Model menjawab tetapi alat gagal

Balasan teks yang berhasil hanya membuktikan generasi dasar. Cline juga bergantung pada panggilan alat terstruktur untuk membaca, mengedit, dan menjalankan perintah. Uji tugas repositori read-only sebelum perubahan otonom yang besar.

Jika suatu model berulang kali menghasilkan pemanggilan alat yang salah, bandingkan model yang didokumentasikan untuk pekerjaan agen daripada menaikkan batas output secara membabi buta.

Biaya lebih tinggi dari perkiraan

Konteks repositori yang panjang dapat mendominasi pembahasan bahkan ketika jawaban akhirnya pendek. Mulailah dengan tugas yang sempit, simpan folder yang tidak terkait di luar konteks, dan bandingkan biaya per perubahan yang diterima.

Gunakan tombol atau penutup terpisah untuk eksperimen. Batasan membatasi eksposur finansial; itu tidak mengurangi token yang digunakan oleh tugas yang tidak efisien.

Daftar periksa keamanan

• Gunakan kunci Cline khusus alih-alih kredensial yang dibagikan dengan layanan produksi.
• Tetapkan batas yang sesuai untuk proyek dan ukuran tugas.
• Putar kunci yang muncul di repositori, rekaman terminal, tangkapan layar, atau masalah.
• Tinjau izin alat sebelum mengizinkan perintah shell atau pengeditan file.
• Mulai repositori baru atau tidak tepercaya dengan tugas hanya-baca.
• Periksa log penggunaan penyedia setelah sesi pertama berhasil.

Kunci API mengontrol akses model. Izin file dan perintah Cline mengontrol apa yang dapat dilakukan agen secara lokal. Perlakukan mereka sebagai batas keamanan yang terpisah.

Pertanyaan yang sering diajukan

Bisakah saya menggunakan kunci API saya sendiri dengan Cline?

Ya. Pilih OpenAI Compatible, lalu masukkan Base URL penyedia, Kunci API, dan Model ID yang tepat. Penyedia harus mengekspos API yang kompatibel dengan antarmuka yang diharapkan Cline.

Apakah kunci Cline kustom API gratis?

Tidak. BYOK mengubah siapa yang mengautentikasi dan menagih permintaan model. Penyedia masih dapat mengenakan biaya untuk input, input cache, dan token output.

Base URL apa yang harus digunakan Cline untuk OmniaKey?

Gunakan https://api.omniakey.com/v1. Jangan tambahkan /chat/completions dan jangan duplikat /v1.

Model mana yang harus saya gunakan di Cline?

Mulailah dengan model terkini dari katalog yang sesuai dengan tugas. gpt-5.6-terra adalah titik awal yang seimbang; gunakan model yang lebih kuat atau lebih murah hanya setelah membandingkan hasil tugas yang diterima.

Mengapa Cline mengatakan Model Tidak Ditemukan?

Periksa Model ID dan Base URL yang tepat. Kunci API yang valid mungkin masih kekurangan akses ke model tertentu, dan 404 juga dapat berasal dari format URL yang salah.

Apakah Cline menyimpan kunci saya di repositori?

Kredensial penyedia termasuk dalam pengaturan Cline, bukan file proyek. Terlepas dari penerapan penyimpanan klien, jangan menyalin kunci ke sumber, perintah, tangkapan layar, atau laporan masalah.

Sumber diperiksa

• Cline: OpenAI Penyedia yang kompatibel
• Cline: Otorisasi dan BYOK
• Referensi konfigurasi OmniaKey Cline
• Katalog model OmniaKey