Preset
Preset menyimpan daftar model cadangan, preferensi penyedia, parameter sampling, dan system prompt dengan satu nama. Kelola preset di akunmu; gateway menggabungkannya ke permintaan sebelum validasi, jadi batas, saldo, dan mode PDP tetap berlaku.
Tiga cara merujuk preset
| Bentuk | Arti |
|---|---|
| "model": "@preset/slug" | Model pertama di preset menjadi model; daftar model preset menjadi models, kecuali permintaan membawa models sendiri. |
| "model": "vendor/model@preset/slug" | Model yang disebut tetap dipakai; pengaturan lain diambil dari preset. |
| "preset": "slug" | Field terpisah. Model dari permintaan tetap dipakai; jika tidak ada model, model preset yang dipakai. |
Aturan penggabungan
- Field di permintaan selalu menang atas nilai preset (temperature, max_tokens, stop, dan lainnya).
- provider dari permintaan menggantikan provider preset secara utuh, tidak digabung per field.
- System prompt preset ditambahkan di awal hanya jika pesan pertama bukan pesan system atau developer.
- Field preset tidak pernah diteruskan ke penyedia.
- Hasil gabungan divalidasi seperti permintaan biasa, jadi preset tidak bisa melewati batas.
Contoh
Preset bernama hemat, dipanggil dengan cURL atau SDK OpenAI biasa:
curl "$ROUTER_BASE_URL/chat/completions" \
-H "Authorization: Bearer $ROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"@preset/hemat","messages":[{"role":"user","content":"Halo!"}]}'Galat
| Bentuk | Arti |
|---|---|
| 400 preset_not_found | Preset tidak ada, milik akun lain, atau diarsipkan. Tidak ada biaya dan tidak ada panggilan ke penyedia. |
| 400 preset_without_model | Preset tidak punya daftar model; gunakan bentuk vendor/model@preset/slug. |