Penyematan Grup
Kunci sebuah model ke grup penyedia tertentu alih-alih perutean termurah.
Setiap model dilayani oleh satu grup penyedia atau lebih, masing-masing dengan harganya sendiri. Secara bawaan, sebuah kunci memakai auto: tiap permintaan menuju grup aktif termurah.
Penyematan menggantikan ini per model. Anda memilih grup mana yang boleh dipakai dan dalam urutan apa grup itu dicoba, dan tagihannya mengikuti tarif mereka.
Tiap halaman model mencantumkan semua grup beserta harga masukan dan keluaran di bagian Group Pricing. Lencana diskon di daftar model mencerminkan grup termurah.

Buka Kunci API, buat atau sunting sebuah kunci, lalu buka pemilih grup. Cari sebuah model, klik, lalu centang satu grup atau lebih. Model yang tidak disentuh tetap memakai auto.

Model yang disematkan diurutkan ke atas dengan lencana yang menunjukkan jumlah grupnya. Clear all mengembalikan kunci ke auto. Daftar kunci menampilkan kunci yang disematkan sebagai auto +N.
Alih-alih mencentang penyedia satu per satu, seret rentang harga bergagang ganda pada sebuah model untuk merutekan hanya melalui penyedia yang tarifnya berada di dalamnya. Karena pemilihan berdasarkan harga dan bukan nama, penyedia baru yang masuk rentang akan dipakai otomatis.

Rentang dan jalur yang disematkan digabungkan: rentang mencakup penyedia murah, dan sematan mempertahankan penyedia mahal tertentu sebagai cadangan meski berada di luar rentang. Dengan Termurah dulu cadangan itu baru dipakai saat semua yang lebih murah gagal; dengan Urutan saya Anda yang menentukan letaknya.
Otomatis mengembalikan model ke rantai normal termurah lebih dulu. Rentang dan sematannya tetap tersimpan tetapi nonaktif, sehingga mematikannya memulihkan persis konfigurasi sebelumnya.

Di bawah daftar jalur, Urutan cadangan menentukan dalam urutan apa jalur yang dipilih dicoba. Termurah dulu adalah bawaan: jalur berjalan dari tarif terendah ke tertinggi, dan daftar menampilkan urutan itu tanpa bisa diubah.

Beralih ke Urutan saya untuk menyeret jalur yang dipilih ke urutan apa pun. Permintaan mencoba jalur teratas lebih dulu dan baru turun jika jalur itu gagal, jadi Anda bisa memilih penyedia yang Anda percaya daripada yang lebih murah. Urutkan menurut harga mengembalikan daftar ke termurah dulu. Jalur yang tidak aktif tetap di tempatnya dan dilewati sampai kembali.

Jika rentang harga diatur, jalur yang ditambahkan rentang tetapi tidak Anda pilih menyusul setelah daftar Anda, yang termurah dulu. Penyedia yang masuk ke rentang belakangan juga ditempatkan di sana.
Model yang disematkan hanya dirutekan melalui grup yang disematkan dan beralih saat terjadi kesalahan, dalam urutan yang diatur di Urutan cadangan. Grup yang melayani permintaan menentukan tarif yang ditagih.
Padukan sematan dengan pantauan agar tahu saat grupnya berubah harga atau tumbang, lihat Notifikasi
Untuk menyematkan satu permintaan tanpa mengubah kuncinya, kirim header X-Group berisi nama grup yang persis. Header itu menimpa sematan kunci dan perutean auto. Salin namanya dari Group Pricing.
curl https://api.test.wanmo.ai/v1/chat/completions \
-H "Authorization: Bearer $UNOROUTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Group: glm-new-relay-glm-5.2" \
-d '{
"model": "glm-5.2",
"messages": [{ "role": "user", "content": "Hello" }]
}'Header harus menyebut grup yang boleh dipakai kunci tersebut, atau permintaannya ditolak. Model tanpa sematan tetap memakai perutean termurah.
Jika semua grup yang disematkan mati sementara penyedia lain masih melayani model itu, permintaan gagal dengan error spesifik, bukan pesan sibuk yang umum:
{
"error": {
"message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
"type": "new_api_error",
"code": "get_channel_failed"
}
}Perluas atau hapus sematannya, atau coba lagi nanti. Modelnya sendiri aktif.