Penyematan Grup

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 menimpa perilaku ini per model. Anda memilih grup mana yang boleh dipakai, dan penagihan dikunci ke tarif grup tersebut.

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, diurutkan dari termurah. 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.

Model yang disematkan hanya dirutekan di dalam grup sematannya, termurah lebih dulu, dan beralih saat terjadi error. Grup yang melayani permintaan itulah yang menentukan tarif tagihannya.

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.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-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.