Cara Setup OpenRouter Presets Biar Ganti Model AI Nggak Usah Redeploy Semua Aplikasi Kalian

TAHAP 1 — Bikin preset pertama di dashboard

Buka openrouter.ai/settings/presets, lalu bikin preset baru. Pilih slug yang gampang kalian inget, karena slug ini yang bakal kalian panggil terus-terusan lewat @preset/slug-kalian.

Cara mikirnya mirip .env file atau modul Terraform — konfigurasi ditaruh di luar logika aplikasi dan dipanggil pakai nama, bukan disalin-tempel ke tiap file. Bedanya, .env masih ikut ke-deploy bareng kode kalian dan butuh redeploy tiap kali diubah. Preset OpenRouter hidup di dashboard mereka, jadi begitu kalian ubah, semua aplikasi yang mereferensikan slug itu langsung ikut berubah — tanpa sentuh kode sama sekali.

TAHAP 2 — Atur model, fallback, dan provider routing

Di preset, kalian bisa pilih satu model atau bikin daftar model cadangan yang terurut. Kalau model pertama gagal — kena rate limit, lagi outage, atau kepenuhan context — OpenRouter otomatis lanjut ke model berikutnya di daftar itu. Urutan ini kalian set sekali di preset, bukan diulang-ulang di tiap request.

Di layar yang sama, kalian atur juga provider routing: urutkan berdasarkan harga atau latency, atau blokir provider tertentu dari request kalian. Bayangin ini kayak milih rute ojek online — kalian bisa pilih rute termurah atau tercepat, dan pilihan itu kepake otomatis tiap kali order tanpa perlu diatur ulang setiap kali.

TAHAP 3 — Tambah system prompt & sampling parameter

Masukkan system prompt kalian, lalu atur temperature, top_p, dan parameter sampling lain yang kalian butuh. Semua ini jadi nilai default untuk setiap request yang manggil preset ini — kalian nggak perlu nulis ulang instruksi yang sama di tiap aplikasi.

Contoh konkret dari dokumentasi resminya: kalau kalian mau semua jawaban singkat, tambahin aturan kayak "jawab dalam tiga kalimat atau kurang kecuali diminta perpanjang" ke system prompt preset. Semua layanan yang manggil preset itu bakal ngikutin aturan itu, kecuali ada request yang sengaja nge-override-nya.

TAHAP 4 — Pasang preset di API call kalian

Sekarang bagian yang paling kerasa bedanya. Sebelum pakai preset, request kalian biasanya penuh parameter yang diulang-ulang:

from openrouter import OpenRouter
client = OpenRouter(api_key=OPENROUTER_API_KEY)

resp = client.chat.send(
    model="[ISI - nama model]",
    provider={"sort": "price"},
    temperature=0.7,
    messages=[
        {"role": "system", "content": "[ISI - system prompt]"},
        {"role": "user", "content": "[ISI - pertanyaan user]"},
    ],
)

Setelah preset kalian aktif, request yang sama jadi jauh lebih ringkas:

resp = client.chat.send(
    model="@preset/[ISI - slug preset kalian]",
    messages=[
        {"role": "user", "content": "[ISI - pertanyaan user]"},
    ],
)

Kalian juga bisa bikin preset langsung lewat API, kirim POST ke endpoint preset — field yang emang bagian dari konfigurasi preset ikut disimpan, sedangkan field sementara kayak messages, stream, dan prompt diabaikan:

curl https://openrouter.ai/api/v1/presets/[ISI - nama-preset]/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "[ISI - nama model]",
    "temperature": 0.7,
    "messages": [
      {"role": "system", "content": "[ISI - system prompt]"}
    ]
  }'

Kalian bisa override nilai preset dari tiap request. Kalau body request kalian bawa temperature sendiri, nilai itu yang menang atas nilai preset. Merge-nya bersifat shallow — field yang kalian tulis di request menggantikan field preset yang sama, sedangkan field yang nggak kalian sebut tetap ikut nilai preset. Pengecualian ada di tools: preset dan request digabung, dan tool dari request menggantikan tool preset kalau namanya sama.

Satu catatan penting: untuk pemanggilan lewat API, nggak ada preset default global — tiap request wajib menyebut nama presetnya sendiri. Kalau kalian mau punya "default behavior", taruh aturan itu di dalam satu preset dan pakai preset itu di mana pun, bukan mengandalkan pengaturan bawaan sistem. Beda cerita kalau kalian pakai Chatroom-nya OpenRouter — di sana ada opsi Default Preset di bagian Settings > Preferences yang otomatis berlaku untuk pesan chat baru.

Checklist sebelum preset kalian dipakai production

• Slug preset gampang diinget dan dipakai konsisten di semua service
• Urutan fallback model udah disusun berdasarkan prioritas kualitas dan biaya
• Provider routing (sort price/latency, include/exclude) udah sesuai kebutuhan tim
• System prompt dan sampling parameter udah final, bukan draft sementara
• Semua kode manggil @preset/nama-slug dengan prefix lengkap, bukan config hardcoded lagi
• Sudah jelas siapa saja di tim yang punya akses dashboard buat ubah preset

Kalau gagal

1. Request masih ikut config lama walau preset udah diubah — cek apakah kode kalian masih ngirim field yang sama secara eksplisit di body request, misalnya temperature manual. Field itu selalu menang di atas nilai preset karena merge-nya shallow, bukan preset-nya yang error.
2. Preset nggak kepanggil sama sekali — cek prefix-nya. Field preset butuh @preset/ lengkap; kalau kalian cuma tulis slug telanjang, sistem mengabaikannya begitu saja.
3. Fallback model kayak nggak pernah kepake — kemungkinan error yang muncul bukan tergolong rate limit, outage, atau context overflow, jadi sistem nggak menganggapnya alasan buat lompat ke model berikutnya. Cek jenis error dari model pertama dulu.
4. Preset production tiba-tiba berubah tanpa kalian sadar — karena preset punya versi dan siapa pun dengan akses dashboard bisa menyimpan versi baru yang langsung aktif ke semua aplikasi, kejadian ini biasanya soal disiplin akses tim, bukan bug sistem.

Setelah preset kalian jalan

Prinsip yang kepake di sini sebenarnya bukan cuma soal OpenRouter — mindahin konfigurasi keluar dari kode ke satu sumber yang bisa diubah tanpa redeploy itu pola yang sama dipakai di banyak infrastruktur modern. Begitu satu preset jalan lancar, pola pikirnya gampang dipindah ke pengaturan lain yang sekarang masih hardcode di kode kalian.

Kalau kalian juga lagi eksplorasi kapabilitas lain di OpenRouter selain preset, OpenRouter juga baru kasih semua model akses terminal dan file lewat shell tool — kombinasi keduanya bikin setup multi-aplikasi kalian makin gampang dikelola dari satu tempat.