Tambah setiap model katalog ke Cherry Studio sebagai satu penyedia.

Updated 2026-07-29

Tetapan Model Services Cherry Studio menerima mana-mana endpoint serasi OpenAI: tambah penyedia dengan jenis OpenAI, arahkan alamat API ke api.apisrouter.com, tampal satu kunci, dan tambah id model secara manual. Claude, GPT, DeepSeek, GLM, Kimi, dan Qwen berada dalam satu pemilih pada desktop.

Jawapan pantas: satu penyedia dalam Model Services.

Klik ikon gear dalam navigasi kiri Cherry Studio, buka tab Model Services, dan klik butang Add di bawah senarai penyedia. Beri penyedia itu nama yang mudah dikenali (APIsRouter) dan pilih OpenAI sebagai jenis penyedia, kemudian simpan. Sekarang pilih penyedia baharu dalam senarai dan konfigurasikannya: togol suis aktifnya, tampal kunci anda ke medan kunci API, dan tetapkan alamat API kepada https://api.apisrouter.com. Perhatikan bentuknya: lalai terdokumentasi Cherry Studio ialah mengambil alamat punca dan melampirkan /v1/chat/completions sendiri, jadi anda masukkan hos tanpa /v1. Kemudian tambah model dengan butang Add dalam bahagian model, satu id katalog tepat per entri (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), dan tekan butang Check bersebelahan kunci untuk menjalankan pengesahan langsung terhadap model yang dipilih.

Provider name:  APIsRouter
Provider type:  OpenAI

kemudian, pada halaman penyedia:
API key:        sk-YOUR-APISROUTER-KEY
API address:    https://api.apisrouter.com
                (Cherry melampirkan /v1/chat/completions)
Models → + Add: claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → pilih model → berjaya

Bagaimana Cherry Studio menyusun URL permintaan.

Cherry Studio (CherryHQ di GitHub, lebih kurang 49K bintang) ialah klien desktop asal-usul China untuk Windows, macOS, dan Linux, terkenal kerana menghantar pratetap untuk beratus-ratus penyedia dan pembantu. Apa sahaja yang tiada dalam senarai pratetap masuk melalui aliran penyedia custom di atas, dan bahagian yang berbaloi difahami ialah medan alamat API. Lalai terdokumentasi: anda membekalkan alamat punca, dan Cherry Studio menggabungkan route OpenAI padanya, jadi https://api.apisrouter.com menjadi https://api.apisrouter.com/v1/chat/completions pada wayar. Jika penyedia menggunakan laluan bukan-standard, mengakhiri alamat dengan # melumpuhkan penggabungan sepenuhnya dan alamat itu digunakan tepat seperti ditaip, iaitu jalan keluar terdokumentasi. Tingkah laku penggabungan mengenai garis condong berhujung telah berubah antara keluaran, jadi jika permintaan 404, baca URL akhir dalam ralat itu dan bukan meneka; bentuk alamat-punca ditambah penggabungan automatik adalah konfigurasi stabil untuk gateway /v1 standard. Sebaik sahaja dikonfigurasi, setiap perbualan menghantar chat completions standard dengan id model yang anda tambah sebagai rentetan biasa. Vendor tidak penting kepada format wayar, itulah yang membenarkan satu entri penyedia membawa id katalog China dan Barat bersama.

Perincian yang berbaloi: pengurusan berbilang-kunci dan model.

Medan kunci API menerima lebih daripada satu kunci: pisahkan kunci dengan koma Inggeris dan Cherry Studio berputar melaluinya atas ke bawah setiap permintaan, ciri load-balancing yang terdokumentasi. Dengan gateway yang mengukur per kunci, ini turut berfungsi sebagai atribusi: satu kunci untuk kerja, satu untuk peribadi, rotasi dimatikan dengan menyenaraikan satu kunci sahaja. Entri model adalah manual dan itu ciri. Cherry Studio menunjukkan tepat apa yang anda tambah, jadi pemilih kekal tersusun dan bukan tenggelam dalam katalog yang diambil. Setiap entri mengambil id sebagai rentetan wayar; butang Manage mengedit atau membuang entri kemudian. Kumpulkan id berkaitan dengan penamaan konsisten dan pemilih itu terbaca seperti menu: tier pantas (deepseek-v4-flash, claude-haiku-4-5-20251001), kekuatan serantau (glm-5.2, qwen3.7-plus, kimi-k2.6), frontier (claude-sonnet-4-6). Butang Check mengesahkan pasangan kunci dan alamat terhadap model yang anda pilih, dan itu cara terpantas mengesahkan penyedia sebelum perbualan sebenar. Semakan yang gagal dengan kunci yang betul hampir selalu bermaksud medan alamat membawa /v1 tersasar yang menggandakan laluan.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# tambah id ini secara verbatim dalam senarai model penyedia

Memilih model untuk kuda beban desktop.

Satu kunci bermaksud perbandingan adalah pertukaran pemilih. Jalankan seminggu kerja yang sama pada dua id calon dan biarkan perbelanjaan per-model dalam konsol APIsRouter menjadi hakim berbanding pembacaan kualiti output anda sendiri.

  • Sembang harian dan penulisan semula pantas hidup pada tier pantas: deepseek-v4-flash dan claude-haiku-4-5-20251001 mengekalkan tetingkap sentiasa terbuka terasa percuma.
  • Kerja bahasa Cina adalah tempat id serantau layak mendapat barisnya: glm-5.2 dan qwen3.7-plus untuk merangka dan dokumen, kimi-k2.6 untuk pembacaan konteks panjang.
  • claude-sonnet-4-6 mengambil perbualan yang anda hantar tanpa edit: analisis berhati-hati, prosa menghadap pelanggan, kod yang anda niatkan untuk dihantar.
  • Pembantu Cherry Studio boleh menyematkan model mereka sendiri per peranan, jadi pembantu terjemahan pada glm-5.2 dan pembantu pengekodan pada claude-sonnet-4-6 wujud bersama di sebalik satu penyedia.
  • Tambah baris dengan sengaja; pemilih enam-model yang tersusun digunakan, manakala katalog yang ditampal masuk hanya diskrol lalu.

Bayar mengikut penggunaan · bawah harga rasmi

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModelHarga RasmiHarga Kami
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
GLM-5.2$1.14 / $4.00 per M$1.10 / $4.00 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Qwen 3.7 Plus$0.29 / $1.14 per M$0.30 / $1.10 per M

Mod kegagalan khusus Cherry Studio.

Laluan tergandakan adalah laporan teratas: menampal https://api.apisrouter.com/v1 ke dalam medan yang melampirkan /v1/chat/completions menghasilkan URL /v1/v1 yang 404. Masukkan alamat punca dan biarkan klien membina route itu. Jika anda perlu menyematkan URL tepat, bentuk # berhujung wujud untuk itu. Check yang gagal dengan kunci yang baik biasanya bentuk alamat di atas; Check yang gagal dengan alamat bersih adalah kunci itu, dan perhatikan berbilang kunci mesti dipisahkan koma Inggeris, kerana aksara lebar-penuh yang ditampal daripada kaedah input Cina merosakkan senarai secara senyap. Model yang memberi ralat secara individu manakala yang lain berfungsi adalah masalah ejaan id; entri adalah teks bebas dan senarai /v1/models adalah sumber berwibawa. Dan ingat tetapan adalah per mesin: penyedia yang dikonfigurasi pada desktop anda tidak wujud pada komputer riba anda sehingga anda mengulangi persediaan dua minit itu atau menggunakan ciri sandaran Cherry Studio sendiri. Nota perbezaan versi: Cherry Studio menghantar keluaran dengan kerap dan label tetapan bergerak (Model Services juga pernah muncul sebagai Model Provider dalam sesetengah binaan); aliran menambah penyedia, memilih jenis OpenAI, kunci, alamat, model kekal stabil.

Siapa yang menghalakan Cherry Studio melalui gateway.

  • Pengguna desktop dwibahasa mencampur GLM, Qwen, Kimi, dan DeepSeek dengan Claude dan GPT dalam satu pemilih, satu baki, tiada akaun setiap vendor.
  • Pengguna di Asia yang mahu id Claude dan GPT pada baki prabayar tanpa kad Barat, bersebelahan model serantau yang sudah mereka gunakan.
  • Pengguna power yang menjalankan pembantu Cherry Studio per peranan yang mahu setiap pembantu disematkan kepada vendor yang betul tanpa menguruskan lima kunci.
  • Orang yang sudah menghalakan alat lain melalui gateway dan mahu klien desktop pada kunci dan log penggunaan yang sama.
  • Sesiapa yang membandingkan model serantau dan Barat pada kerja harian sebenar dan bukan tanda aras, di mana setiap calon adalah satu baris model.

Sahkan endpoint dan nyahpepijat perbualan pertama.

Curl senarai model dahulu dan salin id yang anda rancang untuk ditambah; kemudian jalankan satu chat completion terhadap pemandu harian anda yang dimaksudkan. Dengan kedua-duanya lulus, semua yang tinggal berada pada halaman penyedia. Di dalam Cherry Studio, jalankan Check sebelum bersembang. Kegagalan pengesahan adalah medan kunci atau pemisah komanya. 404 adalah bentuk alamat, baca URL yang disusun dalam ralat dan kira segmen /v1. Ralat tidak-ditemui pada model tertentu adalah ejaan id pada baris itu. Sebaik sahaja perbualan mengalir, konsol APIsRouter menunjukkan model per permintaan, kiraan token, dan perbelanjaan. Klien desktop yang digunakan sepanjang hari kerja menjana aliran berterusan permintaan kecil, dan pandangan penggunaan per-kunci mengubah aliran itu kepada nombor per-model, per-hari, dengan id China dan Barat pada halaman yang sama.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Soalan lazim

Bagaimana saya menambah penyedia custom dalam Cherry Studio?

Ikon gear, tab Model Services, Add. Namakan penyedia, pilih jenis OpenAI, simpan, kemudian pada halamannya aktifkannya, tampal kunci anda, tetapkan alamat API kepada https://api.apisrouter.com, dan tambah id model secara manual. Sahkan dengan butang Check.

Patutkah alamat API termasuk /v1?

Tidak. Lalai terdokumentasi Cherry Studio mengambil alamat punca dan melampirkan /v1/chat/completions sendiri, jadi masukkan https://api.apisrouter.com. Menampal hos /v1 menggandakan laluan dan 404. Untuk menyematkan URL tepat bukan-standard, akhiri alamat dengan # untuk melumpuhkan penggabungan.

Bolehkah Cherry Studio menjalankan Claude, DeepSeek, dan GLM melalui satu penyedia?

Ya. Id setiap baris model bergerak ke alamat sebagai rentetan biasa, jadi claude-sonnet-4-6, deepseek-v4-flash, glm-5.2, kimi-k2.6, dan qwen3.7-plus boleh berkongsi satu entri penyedia dan satu kunci, boleh ditukar per perbualan dan per pembantu.

Apa fungsi ciri kunci dipisahkan koma?

Berbilang kunci dalam medan kunci API, dipisahkan koma Inggeris, diputarkan atas ke bawah merentas permintaan, ciri load-balancing terbina. Dengan pengukuran per-kunci di sisi gateway ia juga berfungsi sebagai atribusi; senaraikan satu kunci sahaja untuk mematikan rotasi.

Mengapa butang Check gagal?

Dengan kunci yang betul, punca biasa adalah alamat yang membawa /v1 tersasar yang menggandakan laluan yang disusun. Dengan alamat yang bersih, semak semula kunci dan pemisahnya; koma lebar-penuh daripada kaedah input Cina secara senyap merosakkan senarai berbilang-kunci.

Mengapa model tidak terisi secara automatik seperti penyedia pratetap?

Penyedia custom menyenaraikan tepat apa yang anda tambah; Cherry Studio tidak mengambil katalog endpoint custom. Itu mengekalkan pemilih tersusun. Ambil id daripada senarai /v1/models dan tambah yang benar-benar anda gunakan, kemudian panjangkan senarai pada hari anda memerlukan yang lain.