Koneksia Labs
IDENBahasa IndonesiaMasukDaftar gratis
Mode uji — saldo dan pembayaran bukan uang nyata.

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.

Kelola preset

Tiga cara merujuk preset

Bentuk rujukan preset di body permintaan
BentukArti
"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

Galat
BentukArti
400 preset_not_foundPreset tidak ada, milik akun lain, atau diarsipkan. Tidak ada biaya dan tidak ada panggilan ke penyedia.
400 preset_without_modelPreset tidak punya daftar model; gunakan bentuk vendor/model@preset/slug.
Preset · Koneksia Labs