Batas free tier OpenRouter dan cara memperbaiki error 429

Jawaban singkat: batas free tier yang persis

OpenRouter membatasi pemakaian gratis di dua sumbu: plafon per menit dan anggaran request harian. Batas per menit untuk varian model gratis (ID model yang berakhiran :free) adalah 20 request per menit. Anggaran harian bergantung pada apakah akun Anda pernah membeli minimal $10 kredit: di bawah ambang lifetime itu Anda dapat 50 request model gratis per hari, di atas atau sama dengan itu Anda dapat 1.000 per hari. Angka-angka ini adalah yang didokumentasikan OpenRouter per awal 2026. Angka ini pernah berubah sebelumnya (batas harian dulu lebih tinggi), jadi anggap tabel ini sebagai baseline saat ini, bukan jaminan permanen, dan verifikasi ke key Anda sendiri dengan pengecekan di bagian berikutnya. Respons 429 berarti Anda melampaui salah satu batas ini, atau provider upstream yang melayani model gratis itu kehabisan kapasitas walaupun kuota pribadi Anda masih aman. Sisa panduan ini membahas cara membedakan mana yang Anda kena dan apa yang harus dilakukan.

Cara kerja free tier sesungguhnya

Model gratis di OpenRouter adalah entri katalog terpisah dengan suffix :free. Model ini dilayani oleh provider yang mendonasikan atau mensubsidi kapasitas, itulah kenapa ketersediaannya jauh lebih fluktuatif dibanding varian berbayar dari weight yang sama. Tiga detail yang sering membuat orang salah paham. Pertama, batas harian berlaku di level akun: 50 request tersebar di kombinasi model gratis apa pun, bukan 50 per model. Kedua, ambang $10 menghitung pembelian kredit lifetime, bukan saldo saat ini. Membeli $10 sekali menjaga Anda tetap di bracket 1.000 request per hari bahkan setelah Anda menghabiskannya. Ketiga, batasnya diterapkan per akun, jadi membuat API key tambahan di akun yang sama tidak menambah apa pun. Anda bisa mengecek persis posisi key Anda. Respons-nya menyertakan is_free_tier, pemakaian Anda sejauh ini, dan objek rate limit yang sedang berlaku untuk key Anda:

curl https://openrouter.ai/api/v1/auth/key \
  -H "Authorization: Bearer $OPENROUTER_API_KEY"

# Field respons yang perlu dibaca:
# "is_free_tier": true    -> masih di bawah ambang lifetime $10
# "usage": 1.42           -> kredit yang terpakai
# "rate_limit": {...}     -> batas per interval pada key ini

Kenapa 429 melonjak di jam sibuk

Batas pribadi Anda hanya setengah dari cerita. Kapasitas gratis adalah pool bersama, dan OpenRouter hanya bisa merutekan request gratis ke provider yang punya kapasitas subsidi tersisa saat itu. Ketika model gratis populer jenuh, Anda kena 429 atau error upstream bahkan kalau Anda baru melakukan segelintir request hari itu. Laporan komunitas secara konsisten menyebut malam hari di zona waktu AS dan akhir pekan sebagai jendela terburuk, dengan request yang sama berhasil langsung di jam sepi. Itu observasi perkiraan, bukan angka yang dipublikasikan, tapi cukup sering berulang untuk direncanakan. Frontend chat memperbesar masalahnya. Interface gaya SillyTavern dan JanitorAI mengirim request completion baru untuk setiap swipe, regenerate, dan giliran group chat, dan beberapa setup proxy melakukan retry otomatis saat gagal. User yang merasa baru mengirim 15 pesan mungkin sebenarnya menghasilkan 40 sampai 50 request, yaitu seluruh anggaran harian akun di bawah ambang $10. Retry otomatis yang agresif juga memperdalam kemacetan di jam sibuk untuk semua orang, itulah kenapa backoff yang disiplin penting. Diagnostik praktisnya: kalau 429 berhenti setelah Anda menunggu sampai reset harian, Anda kena kuota. Kalau ia datang dan pergi dalam jam yang sama sementara jumlah request Anda rendah, Anda sedang melihat kemacetan pool.

Perbaikan, diurutkan dari yang paling ringan

Kalau Anda tetap memakai traffic di free tier, client minimum yang layak menangani 429 secara eksplisit, bukan gagal atau retry membabi buta:

• Baca body error-nya dulu. 429 OpenRouter membedakan antara batas per menit Anda, kuota harian Anda yang habis, dan kemacetan upstream. Perbaiki yang benar-benar Anda kena.
• Hormati Retry-After dan lakukan backoff eksponensial dengan jitter. Menghantam endpoint terus-menerus justru memperpanjang rate limit Anda dan memperparah kemacetan.
• Lewati ambang kredit lifetime $10 sekali saja. Ini mengangkat batas harian dari 50 jadi 1.000 request dan merupakan perbaikan paling berdampak untuk 429 akibat kuota harian.
• Pindahkan traffic yang penting ke varian berbayar dari model yang sama. Model kelas DeepSeek biayanya jauh di bawah satu dolar per juta token, jadi satu malam chat yang berat biasanya biayanya beberapa sen.
• Kurangi volume request di sisi client: matikan auto-regenerasi, hindari swipe yang tidak perlu, dan pangkas context supaya tiap retry lebih murah saat memang terjadi.

import random
import time

import requests

def chat(payload: dict, key: str, retries: int = 5) -> dict:
    for attempt in range(retries):
        r = requests.post(
            "https://openrouter.ai/api/v1/chat/completions",
            headers={"Authorization": f"Bearer {key}"},
            json=payload,
            timeout=120,
        )
        if r.status_code != 429:
            r.raise_for_status()
            return r.json()
        wait = float(r.headers.get("Retry-After", 2 ** attempt + random.random()))
        time.sleep(wait)
    raise RuntimeError("Still rate limited after all retries")

Alternatif kalau 50 request per hari tidak cukup

Kalau pola pemakaian Anda konsisten di atas anggaran gratis, ada empat jalur realistis. Yang tepat bergantung pada apakah bottleneck Anda kuota harian, kemacetan jam sibuk, atau keduanya. Perlu diketahui bahwa opsi berbayar ini berbeda terutama di overhead-nya, bukan di bentuk request-nya: semuanya berbicara dalam format chat completions OpenAI-compatible yang sama, jadi berpindah cukup perubahan base URL dan key, bukan penulisan ulang.

Menjalankan frontend chat di gateway langsung

Gateway langsung mempertahankan bentuk request OpenAI-compatible tapi menghilangkan antrean pool gratis, karena setiap request adalah kapasitas berbayar. APIsRouter adalah salah satu contohnya: bayar sesuai pemakaian tanpa langganan, dan checkout tanpa signup di /topup di mana Anda bayar dulu dan API key dikirim lewat email. Model global berjalan 20% di bawah harga resmi, model China berada di bawah tarif resminya, dan top-up pertama menggandakan saldo awal Anda. Setup frontend mencerminkan yang sudah Anda lakukan dengan OpenRouter. Di SillyTavern, tempel base URL yang berakhir di /v1 (https://api.apisrouter.com/v1) dan daftar model otomatis terisi dari /v1/models dengan key Anda. Konfigurasi proxy JanitorAI butuh endpoint lengkap sebagai gantinya: https://api.apisrouter.com/v1/chat/completions, ditambah nama model dan API key. Untuk traffic chat karakter dan roleplay, keluarga DeepSeek V4 adalah favorit komunitas untuk value, dengan MiMo, GLM-5, dan Kimi K2.6 sebagai pilihan value tambahan. Claude Sonnet 4.6 menulis prosa terkuat untuk creative writing yang aman untuk kerja (SFW) di bawah kebijakan konten Anthropic.

curl https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Pertanyaan umum