Jika Anda sedang mencari pengaturan Cherry Studio API, kemungkinan Anda sudah tahu model router mana yang ingin digunakan. Tugas berikutnya bersifat praktis: tambahkan provider di Cherry Studio, tempelkan API key yang benar, atur alamat API, tambahkan ID model yang Anda inginkan, lalu pastikan provider diaktifkan.
Flatkey cocok dengan alur kerja itu karena memberikan pengguna Cherry Studio satu lapisan akses yang kompatibel dengan OpenAI untuk model yang didukung. Alih-alih membuat akun provider terpisah untuk setiap keluarga model, Anda bisa menggunakan satu Flatkey API key, base URL router Flatkey, dan dashboard Flatkey untuk penggunaan, penagihan, pemilihan model, serta peninjauan routing.
Panduan ini menunjukkan pengaturan Cherry Studio API melalui Flatkey sebagai alur kerja berbasis teks. Panduan ini mengikuti dokumentasi custom-provider Cherry Studio saat ini dan menghindari screenshot aplikasi karena screenshot belum dikonfirmasi reviewer untuk publikasi ini.
Jawaban Singkat: Pengaturan Cherry Studio API Untuk Flatkey
Untuk pengaturan Cherry Studio API standar dengan Flatkey, tambahkan custom provider dan pilih OpenAI sebagai tipe provider. Lalu masukkan Flatkey API key Anda, setel alamat API ke base URL router Flatkey yang kompatibel dengan OpenAI, tambahkan ID model yang ingin Anda gunakan, jalankan pengecekan Cherry Studio, dan aktifkan sakelar provider.
| Field Cherry Studio | Nilai Flatkey | Yang Perlu Diverifikasi |
|---|---|---|
| Nama Provider | Flatkey |
Nama apa pun yang jelas boleh digunakan. Gunakan nama yang nantinya mudah dikenali tim Anda. |
| Tipe Provider | OpenAI |
Cherry Studio mendokumentasikan OpenAI sebagai tipe custom-provider yang didukung. |
| API Key | API key Flatkey Anda | Buat atau salin key dari dashboard Flatkey. Jangan publikasikan atau menempelkannya ke dokumen bersama. |
| Alamat API | https://router.flatkey.ai/v1 |
Gunakan base URL Flatkey yang kompatibel dengan OpenAI. Jangan tempel endpoint lengkap /chat/completions. |
| Model | ID model dari Flatkey | Gunakan katalog harga Flatkey atau konsol sebagai sumber kebenaran sebelum penggunaan produksi. |
| Pengecekan | Gunakan tombol check Cherry Studio | Jika pengecekan gagal, verifikasi key, alamat API, daftar model, dan status enable provider. |
Jika build Cherry Studio Anda secara eksplisit meminta root API address dan otomatis menambahkan /v1/chat/completions, gunakan https://router.flatkey.ai sebagai gantinya. Dokumentasi API Address Cherry Studio sendiri menyatakan bahwa aplikasi dapat menambahkan jalur chat completions standar untuk rute model bahasa besar yang umum, dan juga mendokumentasikan sufiks # untuk rute kustom lengkap. Untuk Flatkey, mulai dengan base URL yang dipublikasikan, lalu gunakan hasil pengecekan untuk menangkap ketidaksesuaian format alamat sebelum mengirim pekerjaan nyata.
Mengapa Menggunakan Flatkey Untuk Akses Cherry Studio API
Pengaturan Cherry Studio API biasanya bukan hanya tentang mendapatkan satu respons chat. Ini tentang menjaga klien AI desktop tetap terhubung ke model yang benar-benar digunakan tim Anda: model bergaya GPT, model yang kompatibel dengan Gemini, DeepSeek, Qwen, model gambar, dan rute lain yang didukung.
Surface produk publik Flatkey dirancang untuk pola akses tersebut:
- Satu API key untuk model AI yang terhubung.
- Satu base URL yang kompatibel dengan OpenAI:
https://router.flatkey.ai/v1. - Satu dashboard untuk key, penggunaan, penagihan, dan routing.
- Katalog model dengan ketersediaan dan sinyal harga terkini.
- Konteks tool publik yang menyebut Cherry Studio sebagai aplikasi yang didukung.
Itu membuat alur kerja Cherry Studio API lebih rapi bagi developer yang menginginkan satu klien desktop dan satu lapisan akses model, tanpa mengubah setiap pengujian model menjadi setup akun provider terpisah.
Sebelum Anda Memulai
Sebelum mengubah pengaturan Cherry Studio, pastikan item berikut:
- Anda bisa masuk ke Flatkey dan mengakses dashboard.
- Anda telah membuat atau dapat membuat Flatkey API key.
- Akun Flatkey Anda memiliki saldo atau akses untuk model yang ingin diuji.
- Anda mengetahui setidaknya satu ID model dari konsol Flatkey atau katalog harga.
- Anda dapat membuka pengaturan Cherry Studio dan mengedit Model Services.
Jangan gunakan key produksi untuk smoke test Cherry Studio API pertama jika tim Anda memiliki kredensial pengembangan dan produksi yang terpisah. Gunakan test key dengan batasan, verifikasi route, lalu tentukan bagaimana Anda ingin mengelola key untuk penggunaan desktop harian.
Langkah 1: Buat Atau Salin Flatkey API Key
Buka dashboard Flatkey dan buat API key untuk Cherry Studio. Beri nama yang jelas, seperti cherry-studio-desktop, agar log penggunaan di kemudian hari lebih mudah ditafsirkan.
Jika tim Anda menggunakan workstation bersama atau beberapa developer, buat key terpisah daripada satu secret bersama. Itu membuat jejak penggunaan Cherry Studio API lebih mudah ditinjau dan lebih aman dicabut jika seseorang meninggalkan proyek.
Simpan key di password manager atau team secret manager Anda. Anda hanya perlu menempelkannya ke field API Key Cherry Studio satu kali selama setup.
Langkah 2: Tambahkan Custom Provider Di Cherry Studio
Dokumentasi Custom Provider Cherry Studio saat ini menjelaskan jalur berikut:
- Buka Cherry Studio.
- Buka Settings.
- Masuk ke Model Services.
- Klik + Add di bawah daftar provider.
- Setel Provider Name menjadi
Flatkey. - Setel Provider Type menjadi
OpenAI. - Klik Add.
Ini membuat kerangka provider. Langkah ini belum menyelesaikan pengaturan Cherry Studio API sampai API key, alamat API, daftar model, pemeriksaan, dan sakelar enable ditangani.
Langkah 3: Masukkan API Key dan Alamat API Flatkey
Setelah menambahkan provider, pilih provider tersebut di daftar provider dan isi bidang-bidang utamanya.
| Field | Yang Harus Dimasukkan | Kesalahan Umum |
|---|---|---|
| API Key | Tempelkan API key Flatkey Anda. | Menggunakan provider key dari OpenAI, Anthropic, Google, atau layanan lain alih-alih key Flatkey. |
| API Address | Gunakan https://router.flatkey.ai/v1 sebagai base URL yang kompatibel dengan OpenAI. |
Menempelkan https://router.flatkey.ai/v1/chat/completions seolah-olah Cherry Studio menginginkan endpoint lengkap. |
| Enable | Nyalakan sakelar provider setelah pemeriksaan berhasil. | Lulus pemeriksaan tetapi membiarkan provider nonaktif, yang menyembunyikan model dari daftar model. |
Dokumentasi API Address Cherry Studio memperingatkan bahwa rute lengkap dapat berperilaku berbeda dari alamat dasar. Untuk alur kerja Cherry Studio API ini, aturan aman yang sederhana adalah: gunakan base URL Flatkey terlebih dahulu, jangan menambahkan endpoint chat-completions sendiri, dan biarkan pemeriksaan memberi tahu Anda apakah versi Cherry Studio Anda mengharapkan variasi alamat root.
Langkah 4: Tambahkan ID Model Flatkey
Cherry Studio dapat mengambil atau mengelola model dari pengaturan provider, tetapi ID model tetap penting. Jika model tidak ditambahkan ke daftar model provider, model tersebut mungkin tidak muncul nantinya di pemilih model Cherry Studio.
Gunakan konsol Flatkey atau katalog harga sebagai sumber terbaru untuk ID model. Cuplikan API harga yang sudah usang untuk artikel ini mengembalikan dukungan endpoint yang kompatibel dengan OpenAI di seluruh katalog Flatkey, termasuk nama model seperti deepseek-chat, gpt-4.1, qwen-max, dan entri lain yang kompatibel dengan OpenAI. Perlakukan contoh-contoh tersebut sebagai bukti yang sudah kedaluwarsa, bukan sebagai daftar rekomendasi permanen.
Untuk smoke test Cherry Studio API pertama, pilih satu model yang dapat diakses oleh akun Anda dan memang ditujukan untuk chat. Tambahkan hanya model itu terlebih dahulu. Setelah pemeriksaan berhasil dan Anda mengirim pesan yang sukses, tambahkan sisa model reguler Anda.
Langkah 5: Jalankan Pemeriksaan Cherry Studio
Cherry Studio mendokumentasikan tombol check di sebelah kotak input API Key. Gunakan sebelum membuka antarmuka chat. Pemeriksaan ini berguna karena menangkap masalah Cherry Studio API yang paling umum sebelum berubah menjadi kegagalan chat yang membingungkan.
Jika pemeriksaan berhasil:
- Pastikan sakelar provider sudah aktif.
- Pastikan model muncul di daftar model.
- Buka chat Cherry Studio baru.
- Pilih provider Flatkey dan model yang Anda pilih.
- Kirim prompt uji kecil.
- Periksa dashboard Flatkey untuk visibilitas penggunaan dan biaya.
Jika pemeriksaan gagal, jangan terus-menerus mengubah field secara acak. Ikuti tabel pemecahan masalah di bawah ini.
Pemecahan Masalah Pengaturan Cherry Studio API
| Masalah | Penyebab Kemungkinan | Perbaikan |
|---|---|---|
| Pemeriksaan langsung gagal | Key salah, key kedaluwarsa, tidak ada akses akun, atau ada spasi yang ikut tertempel. | Salin key Flatkey yang baru dari dashboard dan tempelkan lagi. Jangan sertakan tanda kutip atau spasi. |
| Kesalahan alamat atau 404 | Path pada API Address salah bentuk. | Gunakan https://router.flatkey.ai/v1. Jika build Cherry Studio Anda menambahkan seluruh path /v1/chat/completions, coba https://router.flatkey.ai. |
| Model tidak muncul | Model belum ditambahkan ke daftar model provider. | Gunakan Manage atau + Add di Cherry Studio dan tambahkan ID model yang persis dari Flatkey. |
| Pemeriksaan menggunakan model yang salah | Cherry Studio mungkin menggunakan model chat terakhir yang ditambahkan saat pemeriksaan. | Hapus model uji yang tidak didukung dan simpan satu model chat yang dikenal untuk pemeriksaan pertama. |
| Provider lulus pemeriksaan tetapi hilang di chat | Sakelar enable provider masih off. | Nyalakan sakelar di baris provider setelah pemeriksaan berhasil. |
| Penggunaan sulit dijelaskan nanti | Beberapa orang berbagi satu desktop key. | Buat key Flatkey terpisah berdasarkan pengguna, perangkat, atau lingkungan agar log penggunaan tetap dapat ditinjau. |
Kebanyakan masalah Cherry Studio API berasal dari empat field: API key, alamat API, ID model, dan status enable. Verifikasi itu sebelum mengubah pengaturan model atau membuat provider tambahan.
Perbedaannya Dengan Pengaturan Provider OpenAI Langsung
Pengaturan provider OpenAI langsung mengarahkan Cherry Studio ke satu akun provider. Pengaturan Flatkey Cherry Studio API mengarahkan Cherry Studio ke sebuah gateway yang dapat merutekan model yang didukung melalui satu key dan satu dashboard.
| Area Keputusan | Pengaturan Penyedia Langsung | Pengaturan Flatkey |
|---|---|---|
| API key | Key khusus penyedia. | Key Flatkey untuk model yang didukung. |
| Base URL | URL API khusus penyedia. | https://router.flatkey.ai/v1. |
| Ekspansi model | Tambahkan akun atau key penyedia lain saat diperlukan. | Tambahkan ID model yang didukung dari Flatkey. |
| Tinjauan penagihan | Tinjau masing-masing penyedia secara terpisah. | Gunakan dashboard dan tampilan penagihan Flatkey. |
| Kesesuaian operasional | Cocok untuk satu penyedia. | Lebih baik saat Cherry Studio menjadi klien desktop untuk beberapa keluarga model. |
Jika Anda sudah memindahkan kode atau alat ke pola gateway, baca panduan migrasi API yang kompatibel dengan OpenAI setelah pengaturan ini. Jika stack alat Anda juga mencakup Claude Code atau CC Switch, panduan CC Switch dan Claude Code Flatkey membahas jalur konfigurasi alat yang berdekatan.
Pengaturan Tim yang Direkomendasikan
Untuk pengujian individual, satu key Flatkey di Cherry Studio sudah cukup. Untuk tim, perlakukan pengaturan Cherry Studio API sebagai bagian dari kebijakan akses model Anda.
- Buat key terpisah untuk pengembangan, pengujian menyerupai produksi, dan penggunaan desktop pribadi.
- Beri nama key berdasarkan alat dan pemiliknya, seperti
cherry-studio-leeataucherry-studio-eval. - Gunakan dashboard Flatkey untuk meninjau penggunaan setelah pengujian pertama.
- Tetapkan kontrol kuota sebelum mengundang lebih banyak pengguna desktop.
- Dokumentasikan ID model yang disetujui agar pengguna tidak menambahkan model yang tidak didukung secara acak.
Ini menjaga kemudahan Cherry Studio tanpa kehilangan visibilitas atas siapa yang menggunakan model mana dan berapa biaya setiap alur kerja.
FAQ
Apakah Cherry Studio mendukung API yang kompatibel dengan OpenAI?
Ya. Dokumentasi penyedia kustom Cherry Studio mencantumkan OpenAI sebagai jenis penyedia yang didukung, dan pengaturan layanan modelnya mencakup API Key, API Address, pengelolaan model, pemeriksaan konektivitas, dan status aktif/nonaktif penyedia. Itulah permukaan konfigurasi yang digunakan untuk pengaturan Cherry Studio API ini.
Alamat API apa yang harus saya gunakan untuk Flatkey di Cherry Studio?
Gunakan https://router.flatkey.ai/v1 sebagai base URL Flatkey yang kompatibel dengan OpenAI. Jangan tempelkan endpoint lengkap /chat/completions ke dalam Cherry Studio. Jika versi Cherry Studio Anda mengharapkan alamat root dan menambahkan /v1/chat/completions secara otomatis, gunakan https://router.flatkey.ai dan jalankan ulang pemeriksaan.
Di mana saya mendapatkan API key Cherry Studio untuk Flatkey?
Gunakan API key Flatkey dari dashboard Flatkey. Kolom key Cherry Studio API harus berisi key Flatkey, bukan key OpenAI, Anthropic, Google, atau penyedia langsung lainnya.
Mengapa model saya tidak muncul di Cherry Studio?
Dokumentasi Cherry Studio mengatakan bahwa model yang diambil tetap perlu ditambahkan ke daftar model penyedia. Tambahkan ID model Flatkey yang tepat dengan Manage atau + Add, lalu pastikan penyedia diaktifkan.
Apakah satu key Flatkey bisa menggunakan beberapa model Cherry Studio?
Ya, jika ID model tersebut tersedia untuk akun Flatkey Anda dan dikonfigurasi di Cherry Studio. Untuk log yang lebih rapi, tim tetap sebaiknya mempertimbangkan key terpisah berdasarkan pengguna atau lingkungan.
Apakah saya harus menambahkan beberapa key Flatkey yang dipisahkan koma?
Cherry Studio mendokumentasikan polling multi-key yang dipisahkan koma untuk key penyedia. Untuk Flatkey, mulailah dengan satu key agar pemeriksaan Cherry Studio API pertama Anda lebih mudah di-debug. Tambahkan beberapa key hanya jika tim Anda memiliki alasan yang disengaja untuk rotasi key atau pemisahan penggunaan.
Pemeriksaan Akhir
Pengaturan Cherry Studio API Anda melalui Flatkey siap ketika pemeriksaan berikut lolos:
- Penyedia diberi nama dengan jelas, seperti
Flatkey. - Provider Type adalah
OpenAI. - Kolom API Key berisi key Flatkey yang valid.
- API Address mengarah ke base URL router Flatkey.
- Setidaknya satu ID model Flatkey yang valid ditambahkan.
- Pemeriksaan Cherry Studio berhasil.
- Switch penyedia diaktifkan.
- Prompt uji kecil muncul di log penggunaan Flatkey.
Dapatkan key untuk menghubungkan Cherry Studio ke Flatkey, lalu gunakan Lihat Harga untuk memilih ID model yang Anda inginkan dalam daftar model Cherry Studio Anda.
