Hubungkan Cherry Studio ke CheapTokens: provider kustom, Base URL

Untuk menggunakan CheapTokens di Cherry Studio, tambahkan provider kustom (Settings → Model Provider → Add Provider), masukkan https://api.cheaptokens.dev/v1/ di kolom OpenAI Base URL, tempel API key Anda dan tambahkan id model deepseek-ai/DeepSeek-V4-Flash-0731 secara manual. Lalu periksa key dengan Model Check dan ucapkan halo. Itu saja seluruhnya; satu-satunya detail yang merepotkan adalah garis miring di akhir URL.

Anda membuka aplikasi chat desktop karena ingin satu jendela untuk beberapa model dan satu saldo di belakangnya, bukan satu tab browser per layanan. Cherry Studio dirancang untuk itu: ini adalah workstation AI open-source untuk Windows, macOS dan Linux (AGPL-3.0 Community Edition) dengan chat, agen dan basis pengetahuan, dan ia menerima layanan apa pun yang kompatibel dengan OpenAI sebagai provider kustom. CheapTokens berbicara dalam format OpenAI Chat Completions, jadi cocok. Langkah-langkah di bawah mengikuti halaman dokumentasi Cherry Studio tentang provider kustom, diperiksa pada 7 November 2026; aplikasinya sendiri berubah, jadi jika sebuah label sudah berpindah, carilah kata yang sama di sekitarnya.

Yang Anda butuhkan sebelum membuka aplikasi#

Tiga hal, semuanya singkat:

• Base URL: https://api.cheaptokens.dev/v1/ (dengan garis miring di akhir — alasannya ada di bagian berikutnya);
• API key dari akun CheapTokens Anda, disimpan di tempat yang bisa Anda salin, jangan ditempel ke catatan bersama;
• id model lengkap. Nama pendek dari daftar harga tidak diterima oleh API; gunakan id gateway, misalnya deepseek-ai/DeepSeek-V4-Flash-0731. Id lainnya ada di panduan list-models dan di dokumentasi CheapTokens.

Tambahkan provider kustom#

Buka Settings (ikon roda gigi), lalu Model Provider. Di bagian bawah daftar provider ada + Add Provider. Klik dan dialog Add Custom Provider muncul.

Isi seperti ini:

Cherry Studio menampilkan kolom endpoint 'OpenAI' dan 'Anthropic' secara default. Isi hanya protokol yang benar-benar Anda gunakan; untuk chat biasa itu yang OpenAI, dan kolom Anthropic bisa dibiarkan kosong. Di bawah setiap kolom Base URL aplikasi menampilkan pratinjau jalur request akhir. Bacalah. Itu cara tercepat menangkap alamat yang salah sebelum Anda mengirim apa pun.

Klik Add untuk menyimpan.

Mengapa garis miring di akhir penting#

Cherry Studio membangun URL request dari Base URL Anda dengan tiga aturan dalam dokumentasinya (diperiksa 7 November 2026):

• alamat root seperti https://example.com akan ditambahkan /v1/chat/completions;
• alamat yang berakhiran / hanya akan ditambahkan chat/completions;
• alamat yang berakhiran # digunakan persis seperti yang diketik, tanpa tambahan apa pun.

CheapTokens berada di bawah /v1, jadi https://api.cheaptokens.dev/v1/ adalah bentuk yang berubah menjadi https://api.cheaptokens.dev/v1/chat/completions — jalur yang diharapkan API. Pratinjau di bawah kolom harus terbaca persis seperti itu. Jika Anda melihat /v1/v1/ atau tidak ada /v1 sama sekali, perbaiki kolomnya sebelum melanjutkan.

Key, model dan Model Check#

Kembali di halaman provider ada lima langkah kecil. Lakukan dengan urutan ini:

Catatan untuk langkah 5. Halaman ini juga memiliki tombol Sync models yang mengambil daftar model dari layanan. Rute yang andal adalah menambahkan id sendiri dengan +: ketik deepseek-ai/DeepSeek-V4-Flash-0731 persis, dengan bagian deepseek-ai/. Model mana yang bisa Anda tambahkan:

Model Check adalah tombol di samping kolom key; menurut dokumentasi Cherry Studio, ia memeriksa bahwa key valid. Jika ia mengeluh, lompat ke bagian error di bawah: penyebabnya biasanya salah satu dari tiga kolom.

Kirim pesan pertama#

Buka chat baru, pilih provider CheapTokens dan model yang Anda tambahkan di pemilih model di bagian atas, lalu tulis sesuatu yang singkat, seperti 'Jelaskan apa itu token dalam dua kalimat.' Balasan dari model berarti seluruh rantai berfungsi: key, alamat, id model.

Ingin melihat request tanpa aplikasi? Berikut panggilan Chat Completions biasa:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Explain what a token is in two sentences."}]}'

Balasannya adalah JSON dengan teks di choices[0].message.content dan jumlah token di usage.

Model mana yang dipasang di chat desktop#

Jendela chat adalah pekerjaan yang berbeda dari loop agen: Anda bertanya, membaca, bertanya lagi. Dua hal lalu penting: seberapa panjang jawabannya dan seberapa besar percakapan yang muat.

• DeepSeek-V4-Flash — pilihan default untuk chat umum dan dokumen panjang: hingga 32,768 token output per jawaban, konteks 380K, satu harga di jam berapa pun. Secara total, dengan input dan output dihitung bersama, ini lebih murah daripada OpenRouter.
• GLM-5.3-Flash — chat sehari-hari dengan jendela terbesar dari ketiganya (390K), lebih murah daripada OpenRouter baik pada input maupun output.
• MiniMax-M2.7 — chat dan tugas bergaya agen dengan konteks 180K, lebih murah daripada OpenRouter di kedua sisi.

Ketiganya berada di belakang satu saldo, jadi Anda bisa menambahkan ketiga id ke provider yang sama dan beralih di pemilih model tanpa menyentuh key.

Berapa biaya satu sesi chat#

Berikut gambaran kasarnya. Katakanlah Anda punya percakapan 20 pesan. Setiap pesan mengirim ulang riwayat sebelumnya, jadi satu request rata-rata sekitar 6,000 token masuk dan 500 token keluar (alasannya dibahas di mengapa chat panjang lebih mahal). Satu request pada DeepSeek-V4-Flash berbiaya $0.00014. Dua puluh di antaranya ada di kalkulator di bawah; geser slider agar sesuai dengan chat Anda sendiri.

Tabel di bawah menjalankan sesi yang sama pada semua model, dengan kolom OpenRouter sebagai pembanding:

Untuk harga terkini per 1M token lihat harga CheapTokens.

Jika tidak berhasil#

Sebagian besar masalah berasal dari tiga kolom yang sama: key, URL, id model. Cocokkan apa yang Anda lihat dengan penyebabnya:

Untuk penjelasan lebih panjang tentang error ini, lihat API 401 atau 404: key, base URL atau id model yang salah. Dan jika Anda lebih suka chat berbasis browser daripada aplikasi desktop, Open WebUI bekerja dengan cara yang sama.

Sumber: dokumentasi Cherry Studio, halaman provider kustom dan pengaturan provider, diperiksa 7 November 2026; proyeknya ada di github.com/CherryHQ/cherry-studio.