Kimicode sebagai Alternatif Cursor: Pengaturan Endpoint Kustom

Apa yang berfungsi dan apa yang harus diharapkan

Banyak editor kode dengan chat bawaan memungkinkan Anda mengganti endpoint OpenAI dengan endpoint Anda sendiri. Satu pengaturan itu yang memungkinkan hal ini. Anda memberikan editor tiga hal: base URL, kunci API, dan nama model. Sisanya adalah perilaku editor sendiri.

API di sini adalah layanan yang di-host, kompatibel dengan OpenAI, dengan satu model open-weight, dijalankan oleh penyedia independen dan disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan layanan Kimi sendiri dan bukan router lintas vendor, jadi tidak ada pemilih model. Anda mendapatkan uncensored, dan itu satu-satunya ID model.

Jadilah realistis tentang kecocokan. Saya tidak mengklaim model ini mengalahkan apa pun yang dikirim editor Anda secara default saat menulis kode, dan saya tidak memiliki benchmark untuk ditunjukkan kepada Anda. Yang Anda dapatkan adalah kendali: endpoint Anda sendiri, penagihan per token sebesar $0,15 per 1M input dan $0,50 per 1M output, dan model yang tidak menolak permintaan karena topiknya. Yang Anda korbankan adalah fitur apa pun yang hanya diaktifkan editor untuk modelnya sendiri.

Langkah demi langkah: penggantian base URL

1. Masuk dan buka halaman kunci API. Buat kunci. Pengguna baru dapat mengklaim kredit uji coba senilai $0,50 di sana dengan satu klik, tanpa perlu kartu, berlaku selama 7 hari.
2. Di editor Anda, buka pengaturan model atau API. Cursor, misalnya, memiliki opsi untuk mengganti base URL OpenAI di pengaturan modelnya. Nama dan lokasi opsi itu berubah antar-rilis, jadi periksa dokumentasi editor sendiri jika Anda tidak menemukannya.
3. Masukkan base URL: https://api.kimicode.cc/v1. Jangan tambahkan /chat/completions.
4. Tempel kunci Anda ke bidang kunci OpenAI.
5. Tambahkan model kustom bernama uncensored dan pilih di panel obrolan.
6. Jalankan pertanyaan uji kecil. Jika editor menampilkan kesalahan, buka konsol dev atau log dan lihat status HTTP. 401 adalah masalah kunci, 404 adalah masalah URL, dan 429 adalah batas laju.

Beberapa editor memverifikasi kunci dengan memanggil nama model yang di-host yang tidak ada di sini. Jika verifikasi gagal tetapi chat berfungsi, abaikan langkah verifikasi. Jika editor menolak menyimpan tanpa itu, gunakan alat lain dari bagian berikutnya.

Ingat batas uji coba Anda saat pengujian: 2 permintaan paralel dan 60 per menit. Editor yang menembakkan beberapa permintaan latar belakang sekaligus, seperti autocomplete plus chat, dapat mencapai batas konkurensi. Kunci penuh memungkinkan 8 konkuren dan 300 per menit.

Editor dan alat lain yang menerima endpoint kustom

Jika editor Anda tidak menerima base URL kustom, beberapa alat open-source akan melakukannya. Masing-masing mengambil tiga nilai yang sama. Periksa dokumentasi mereka untuk nama opsi terbaru, karena ini berubah.

Aider membaca variabel lingkungan OpenAI standar dan mengambil model yang kompatibel dengan OpenAI dengan awalan openai/:

Copyexport OPENAI_API_BASE="https://api.kimicode.cc/v1"
export OPENAI_API_KEY="YOUR_KEY"
aider --model openai/uncensored

Continue, ekstensi untuk VS Code dan JetBrains, menerima entri model dengan provider diatur ke openai dan basis API. Format file berbeda antar-versi, jadi ini adalah bentuk yang harus dicari:

Copy{
  "models": [
    {
      "title": "Kimicode API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.kimicode.cc/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

Cline menawarkan provider yang kompatibel dengan OpenAI di pengaturannya, di mana Anda memasukkan base URL, kunci, dan ID model yang sama. Dalam semua kasus polanya sama: pilih provider yang kompatibel dengan OpenAI, bukan yang dinamai berdasarkan vendor.

System prompt yang cocok untuk pekerjaan kode

Editor biasanya menambahkan instruksi mereka sendiri, tetapi banyak yang memungkinkan Anda menambahkan aturan kustom atau system prompt. Prompt pendek dan spesifik mengalahkan prompt panjang. Berikut adalah titik awal yang dapat Anda sesuaikan:

Anda adalah asisten kode yang bekerja di proyek pengguna. Jawab dengan perubahan terkecil yang memecahkan masalah. Tampilkan diff atau fungsi yang diubah, bukan seluruh file. Jika persyaratan tidak jelas, ajukan satu pertanyaan sebelum menulis kode. Nyatakan asumsi apa pun yang Anda buat tentang versi atau framework.

Mengapa baris-baris ini? "Perubahan terkecil" memangkas token output, yang merupakan sisi yang lebih mahal pada $0,50 per 1M. "Tampilkan diff" melakukan hal yang sama dan memudahkan review. "Ajukan satu pertanyaan" mencegah jawaban panjang yang salah. "Nyatakan asumsi" memberi Anda tempat untuk menangkap kesalahan sebelum mencapai kode Anda.

Jaga suhu tetap rendah untuk kode. Nilai sekitar 0,2 hingga 0,4 memberikan output yang lebih stabil, dan Anda dapat meneruskan seed jika Anda menginginkan hasil yang dapat diulang saat men-debug prompt. Keduanya diteruskan ke model.

Skrip ketika editor kurang memadai

Ketika fitur editor tidak cocok dengan endpoint kustom, skrip dua puluh baris menutupi kesenjangan dan memberi Anda kendali penuh atas apa yang dikirim. Yang ini membaca file, meminta review dengan system prompt Anda sendiri, dan mencetak jawaban saat streaming.

Copyimport os, sys
from openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.cc/v1", api_key=os.environ["KIMICODE_KEY"])

SYSTEM = (
    "You are a careful code reviewer. List real bugs first, then risky spots. "
    "Quote the line you mean. Skip style comments."
)

path = sys.argv[1]
code = open(path, encoding="utf-8").read()

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    temperature=0.3,
    messages=[
        {"role": "system", "content": SYSTEM},
        {"role": "user", "content": f"Review {path}:\n\n{code}"},
    ],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

Jalankan sebagai python review.py app/server.py. File 1.000 token dengan review 600 token biayanya $0,00015 + $0,0003 = $0,00045. Anda dapat meninjau beberapa ribu file dengan biaya di bawah $2.

Pola yang sama berfungsi untuk pesan commit, pembuatan tes, dan docstring. Ikat skrip ke kunci di editor Anda dan Anda memiliki perintah kustom tanpa plugin sama sekali.

Di mana ini cocok dan di mana tidak

Pengaturan ini sangat cocok jika Anda ingin endpoint Anda sendiri, penagihan per token, dan model yang tidak akan menolak tugas karena subjeknya. Ini cocok untuk pengembang solo, tim kecil, dan orang yang membangun alat yang terhubung ke beberapa provider melalui satu pustaka klien.

Ini adalah kecocokan yang lebih lemah jika Anda bergantung pada fitur yang hanya berfungsi dengan model yang di-host editor sendiri, seperti autocomplete inline yang disesuaikan dengan model tertentu, atau fitur berbasis gambar. Jika itu adalah inti dari cara kerja Anda, pertahankan default dan gunakan API ini untuk panel chat dan skrip. Menggabungkan keduanya umum dan tidak memerlukan biaya tambahan.

Jika Anda hanya ingin melihat bagaimana rasanya, klaim uji coba di halaman kunci API dan ajukan tiga pertanyaan dari tugas Anda saat ini kepada editor. Bandingkan jawabannya dengan yang Anda dapatkan sekarang. Pengujian ini memakan waktu sepuluh menit dan menggunakan sepersekian sen.

Batas jujur model hanya teks

Tiga batas layak diketahui sebelum Anda beralih.

Hanya teks. Tidak ada input gambar dan tidak ada endpoint embedding. Jika editor Anda mengindeks basis kode dengan embedding, indeks itu membutuhkan sumber lain atau fitur tetap tidak aktif. Menempelkan screenshot kesalahan juga tidak akan berhasil; tempel teks kesalahan.

Jendela 100.000 token. Itu adalah jumlah prompt dan hasil. Sebagai aturan kasar, kode berjalan sekitar tiga hingga empat karakter per token, sehingga file besar berukuran 40 KB adalah sekitar 10.000 hingga 13.000 token. Editor yang melampirkan banyak file dapat mencapai batas dengan cepat. Saat Anda melihat kesalahan konteks, lampirkan lebih sedikit file, bukan lebih banyak.

Tidak ada pengalihan tersembunyi. Anda mendapatkan satu model. Jika model tidak menjawab dengan benar pada suatu tugas, tidak ada model cadangan di balik layar, jadi ubah frasa, tambahkan contoh, atau persempit pertanyaan.

Dari segi biaya, pertanyaan coding khas dengan 20.000 token input dan 1.000 token output adalah $0,003 + $0,0005 = $0,0035. Lima puluh pertanyaan seperti itu dalam sehari adalah $0,175. Halaman harga mencantumkan isi saldo mulai dari $20 hingga $500 dengan bonus mulai dari $50, dan saldo tidak pernah kedaluwarsa. Prompt tidak digunakan untuk pelatihan.

Daftar periksa sebelum Anda berkomitmen

• Uji dengan kredit uji coba pada tugas nyata dari proyek Anda sendiri, bukan prompt contoh.
• Periksa apakah streaming berfungsi di editor Anda. Jika jawaban hanya muncul di akhir, editor mungkin melakukan buffering.
• Pastikan pemanggilan alat terhubung dengan baik jika Anda menggunakan fitur agen. API ini mendukung tools dan tool_calls yang di-streaming, tetapi editor memutuskan apakah akan mengirimkannya.
• Baca panduan cepat sekali, termasuk bagian tentang kode kesalahan.
• Tentukan batas pengisian saldo bulanan. Karena penagihan prabayar, jumlah maksimum yang dapat Anda habiskan adalah saldo yang telah Anda tambahkan.

Desain prabayar adalah jaring pengaman untuk editor yang menjalankan loop agen. Loop yang salah berhenti ketika saldo habis, bukan menghasilkan tagihan kejutan.

Panduan lainnya

• Harga API Kimi Code vs Token Bayar Sesuai Penggunaan
• URL API Kimi Code: Pengaturan URL Dasar untuk Klien OpenAI
• API Groq: Mitos vs Fakta untuk LLM Tanpa Sensor