Reseller/ID & batasan pengguna akhir
ID pengguna akhir
Jika satu akun atau satu API key melayani banyak pengguna akhir Anda, kirim header X-End-User-Id pada setiap request untuk menyatakan request itu milik pengguna akhir yang mana. Saat satu pengguna akhir terus melanggar, Wokey hanya membatasi pengguna akhir tersebut, pengguna Anda yang lain tetap dapat bekerja, dan notifikasi dalam aplikasi memberi tahu Anda siapa penggunanya.
Di halaman iniexpand_more
Mengirim headerlink
curl https://api.wokey.ai/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "X-End-User-Id: u_3f8a2c1e9b7d" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "Hello" }
]
}'- Nilainya adalah ID pengguna akhir milik Anda sendiri: 1 sampai 128 karakter ASCII yang terlihat (huruf, angka, dan simbol; tanpa spasi atau karakter non-ASCII). Gunakan UUID, ID internal, atau hash-nya, jangan pernah alamat email, nomor telepon, atau informasi pribadi lainnya. Nilai yang sudah Anda kirim sebagai safety_identifier OpenAI atau metadata.user_id Anthropic bisa langsung dipakai. Untuk pengguna yang belum masuk, kirim ID sesi atau hilangkan header ini; nilai tetap seperti anonymous atau guest membuat banyak orang dianggap satu pengguna akhir dan dibatasi bersama.
- Chat Completions, Responses, dan Messages semuanya menerimanya. Header ini hanya untuk Wokey dan tidak pernah diteruskan ke upstream. Dengan SDK, tambahkan untuk seluruh klien lewat default_headers (Python) atau defaultHeaders (Node.js), atau per request lewat extra_headers.
Pembatasanlink
- Aturannya sama dengan pembatasan tingkat akun, tetapi hanya berlaku untuk pengguna akhir tersebut: pelanggaran berulang oleh satu pengguna akhir pada satu model dalam waktu singkat mula-mula membuatnya terkena rate limit pada model itu (1 request bersamaan, 10 request per menit); jika pelanggaran berlanjut, model itu dijeda untuk pengguna akhir tersebut selama 24 jam, lalu pulih otomatis; beberapa model yang dijeda dalam 30 hari menjeda semua panggilan model pengguna akhir itu sampai tim dukungan memulihkannya.
- Request yang melebihi rate limit seorang pengguna akhir mengembalikan HTTP 429 rate_limit_exceeded, dan request dari pengguna akhir yang dijeda mengembalikan HTTP 403 request_blocked. Keduanya tidak sampai ke upstream dan tidak dikenai biaya. Saat seorang pengguna akhir dijeda, Anda menerima notifikasi dalam aplikasi berisi ID pengguna akhir, model, dan kapan akses pulih; notifikasi dalam satu jam digabung menjadi satu.
- Header ini tidak pernah melonggarkan batas pada akun Anda: pelanggaran tetap dihitung pada akun Anda dengan atau tanpa header ini, sesuai pembatasan tingkat akun. Request dari pengguna akhir yang dijeda tidak lagi sampai ke upstream, sehingga tidak lagi dihitung pada akun Anda. Request yang benar-benar memicu pelanggaran tetap dikenai biaya penanganan pelanggaran seperti biasa.
Mengelola di konsollink
Akun enterprise dan reseller dapat meninjau pengguna akhir yang dibatasi beserta alasan penolakannya selama 7 hari terakhir di tab “Pengguna akhir” pada konsol API, dan mencabut sendiri rate limit atau jeda. Setiap pengguna akhir dapat dipulihkan dengan cara ini sekali setiap 24 jam; pengguna akhir yang dijeda di semua model tetap memerlukan tim dukungan. Hubungi tim dukungan untuk mengaktifkan tab ini.
Nilai tidak validlink
Nilai yang tidak valid (terlalu panjang, berisi spasi atau karakter non-ASCII, atau header dikirim dua kali dalam satu request) diperlakukan seolah-olah header tidak ada: request selesai seperti biasa, dan setiap API key menerima satu pengingat dalam aplikasi per hari.