Had tier percuma OpenRouter dan cara baiki ralat 429

Jawapan pantas: had tier percuma yang tepat

OpenRouter hadkan penggunaan percuma pada dua paksi: siling per minit dan bajet permintaan harian. Had per minit untuk varian model percuma (ID model berakhiran :free) ialah 20 permintaan seminit. Bajet harian bergantung sama ada akaun anda pernah beli sekurang-kurangnya $10 kredit: di bawah ambang seumur hidup itu anda dapat 50 permintaan model percuma sehari, pada atau melebihi itu anda dapat 1,000 sehari. Angka ini ialah yang OpenRouter dokumenkan setakat awal 2026. Ia pernah berubah sebelum ini (had harian dulu lebih tinggi), jadi anggap jadual ini sebagai garis dasar semasa berbanding jaminan kekal, dan sahkan terhadap kunci anda sendiri dengan semakan di bahagian seterusnya. Respons 429 bermaksud anda melebihi salah satu had ini, atau penyedia hulu yang melayan model percuma itu kehabisan kapasiti walaupun kuota peribadi anda okay. Selebihnya panduan ini meliputi cara tahu mana yang anda kena dan apa nak buat.

Bagaimana tier percuma sebenarnya berfungsi

Model percuma di OpenRouter ialah entri katalog berasingan dengan sufiks :free. Ia dilayan oleh penyedia yang menderma atau mensubsidi kapasiti, itulah sebabnya ketersediaannya berubah-ubah jauh lebih daripada varian berbayar berat yang sama. Tiga perkara yang selalu buat orang tersalah faham. Pertama, had harian ialah seluruh akaun: 50 permintaan tersebar merentas mana-mana campuran model percuma, bukan 50 per model. Kedua, ambang $10 kira pembelian kredit seumur hidup, bukan baki semasa. Beli $10 sekali kekalkan anda dalam bracket 1,000 permintaan sehari walaupun selepas anda habiskannya. Ketiga, had dikuatkuasakan per akaun, jadi mencipta kunci API tambahan di bawah akaun yang sama tak tambah apa-apa. Anda boleh semak tepat di mana kunci anda berdiri. Respons termasuk is_free_tier, penggunaan anda setakat ini, dan objek had kadar yang sedang dikenakan pada kunci anda:

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

# Medan respons yang perlu dibaca:
# "is_free_tier": true    -> di bawah ambang seumur hidup $10
# "usage": 1.42           -> kredit yang digunakan
# "rate_limit": {...}     -> had per selang pada kunci ini

Kenapa 429 melonjak waktu puncak

Had peribadi anda cuma separuh cerita. Kapasiti percuma ialah kolam berkongsi, dan OpenRouter cuma boleh halakan permintaan percuma kepada penyedia dengan kapasiti disubsidi yang berbaki pada masa itu. Apabila model percuma popular tepu, anda kena 429 atau ralat hulu walaupun anda cuma buat segelintir permintaan hari itu. Laporan komuniti secara konsisten menyebut waktu malam di zon waktu AS dan hujung minggu sebagai tetingkap paling teruk, dengan permintaan yang sama berjaya serta-merta pada waktu sepi. Itu pemerhatian anggaran, bukan angka terbitan, tetapi cukup kerap berulang untuk dirancang. Frontend chat memperbesarkan masalah ini. Antara muka gaya SillyTavern dan JanitorAI hantar permintaan completion baharu untuk setiap swipe, regenerate, dan giliran chat kumpulan, dan sesetengah persediaan proksi cuba semula secara automatik apabila gagal. Pengguna yang rasa dia baru hantar 15 mesej mungkin sebenarnya jana 40 hingga 50 permintaan, iaitu seluruh bajet harian akaun di bawah ambang $10. Cuba semula automatik yang agresif juga memperdalam kesesakan waktu puncak untuk semua orang, itulah sebabnya backoff yang berdisiplin penting. Diagnostik praktikalnya: kalau 429 berhenti selepas anda tunggu sehingga reset harian, anda kena kuota. Kalau ia datang dan pergi dalam jam yang sama sementara bilangan permintaan anda rendah, anda nampak kesesakan kolam.

Pembaikan, mengikut susunan usaha

Kalau anda kekal trafik pada tier percuma, klien minimum yang layak kendalikan 429 secara eksplisit berbanding gagal atau cuba semula membuta tuli:

• Baca body ralat dulu. 429 OpenRouter membezakan antara had per minit anda, kuota harian anda yang habis, dan kesesakan hulu. Baiki yang anda betul-betul kena.
• Hormati Retry-After dan backoff secara eksponen dengan jitter. Menghentam endpoint terus-menerus kekalkan anda dihadkan kadar lebih lama dan memburukkan kesesakan.
• Lepasi ambang kredit seumur hidup $10 sekali sahaja. Ia angkat had harian daripada 50 kepada 1,000 permintaan dan ialah pembaikan paling berimpak untuk 429 akibat kuota harian.
• Pindahkan trafik yang penting ke varian berbayar model yang sama. Model kelas DeepSeek berharga jauh di bawah satu dolar per juta token, jadi satu malam chat yang berat biasanya berharga beberapa sen.
• Kurangkan volum permintaan di sisi klien: matikan auto-regenerasi, elak swipe tak perlu, dan potong konteks supaya setiap cuba semula lebih murah bila ia betul-betul berlaku.

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 permintaan sehari tak cukup

Kalau corak penggunaan anda konsisten melebihi bajet percuma, ada empat laluan realistik. Yang tepat bergantung sama ada bottleneck anda kuota harian, kesesakan waktu puncak, atau kedua-duanya. Perlu diketahui pilihan berbayar ini berbeza terutamanya pada overhead, bukan bentuk permintaan: semuanya bercakap format chat completions serasi OpenAI yang sama, jadi bertukar cuma perubahan base URL dan kunci berbanding penulisan semula.

Menjalankan frontend chat pada gateway terus

Gateway terus kekalkan bentuk permintaan serasi OpenAI tetapi buang giliran kolam percuma, kerana setiap permintaan ialah kapasiti berbayar. APIsRouter ialah satu contoh: bayar ikut guna tanpa langganan, dan checkout tanpa daftar di /topup di mana anda bayar dulu dan kunci API sampai melalui e-mel. Model global berjalan 20% di bawah senarai rasmi, model China berada di bawah kadar rasminya, dan top-up pertama menggandakan baki permulaan anda. Persediaan frontend mencerminkan apa yang anda sudah buat dengan OpenRouter. Dalam SillyTavern, tampal base URL yang berakhir di /v1 (https://api.apisrouter.com/v1) dan senarai model automatik terisi daripada /v1/models dengan kunci anda. Konfigurasi proksi JanitorAI perlukan endpoint penuh sebaliknya: https://api.apisrouter.com/v1/chat/completions, ditambah nama model dan kunci API. Untuk trafik chat watak dan roleplay, keluarga DeepSeek V4 ialah kegemaran komuniti untuk value, dengan MiMo, GLM-5, dan Kimi K2.6 sebagai pilihan value tambahan. Claude Sonnet 4.6 menulis prosa terkuat untuk penulisan kreatif selamat-untuk-kerja di bawah dasar kandungan 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"}]
  }'

Soalan lazim