Bayiler/Son kullanıcı kimliği ve limitler

Son kullanıcı kimliği

Tek bir hesap veya tek bir API anahtarı çok sayıda son kullanıcınıza hizmet veriyorsa, isteğin hangi son kullanıcıya ait olduğunu belirtmek için her istekte X-End-User-Id başlığını gönderin. Bir son kullanıcı ihlale devam ederse Wokey yalnızca o son kullanıcıyı kısıtlar, diğer kullanıcılarınız çalışmaya devam eder ve uygulama içi bir bildirim size hangi kullanıcı olduğunu söyler.

Bu sayfadaexpand_more

Başlığı göndermelink

cURL
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" }
    ]
  }'
  • Değer, sizin kendi son kullanıcı kimliğinizdir: 1 ila 128 görünür ASCII karakter (harf, rakam ve semboller; boşluk veya ASCII dışı karakter olmadan). UUID, dahili bir kimlik veya bunun hash’ini kullanın; asla e-posta adresi, telefon numarası veya başka bir kişisel bilgi kullanmayın. Hâlihazırda OpenAI safety_identifier veya Anthropic metadata.user_id olarak gönderdiğiniz değer olduğu gibi çalışır. Oturum açmamış kullanıcılar için bir oturum kimliği gönderin veya başlığı hiç göndermeyin; anonymous veya guest gibi sabit bir değer birçok kişiyi tek bir son kullanıcı yapar ve hepsi birlikte kısıtlanır.
  • Chat Completions, Responses ve Messages bu başlığı kabul eder. Başlık yalnızca Wokey içindir ve hiçbir zaman upstream’e iletilmez. SDK kullanıyorsanız tüm istemci için default_headers (Python) veya defaultHeaders (Node.js) ile, istek bazında ise extra_headers ile ekleyin.

Kısıtlamalarlink

  • Kurallar hesap düzeyindeki kısıtlamalarla aynıdır ancak yalnızca o son kullanıcıya uygulanır: bir son kullanıcının bir modelde kısa süre içinde tekrarlanan ihlalleri önce o modelde kendisine hız limiti getirir (1 eşzamanlı istek, dakikada 10 istek); ihlaller sürerse o model son kullanıcı için 24 saat duraklatılır ve ardından otomatik olarak geri gelir; 30 gün içinde birden fazla modelin duraklatılması, destek ekibi yeniden açana kadar son kullanıcının tüm model çağrılarını duraklatır.
  • Bir son kullanıcının hız limitini aşan istekler HTTP 429 rate_limit_exceeded, duraklatılmış bir son kullanıcının istekleri ise HTTP 403 request_blocked döndürür. İkisi de upstream’e ulaşmaz ve ücretlendirilmez. Bir son kullanıcı duraklatıldığında son kullanıcı kimliğini, modeli ve erişimin ne zaman geri geleceğini içeren bir uygulama içi bildirim alırsınız; bir saat içindeki bildirimler tek bildirimde birleştirilir.
  • Başlık, hesabınızdaki limitleri hiçbir zaman gevşetmez: ihlaller, başlık olsun olmasın hesap düzeyindeki kısıtlamalar kapsamında hesabınıza sayılır. Duraklatılmış bir son kullanıcının istekleri artık upstream’e ulaşmadığı için hesabınıza sayılmaz. Gerçekten ihlal tetikleyen istekler için her zamanki gibi ihlal işlem ücreti alınır.

İhlal işlem ücretleri ve kısıtlamalar →

Konsolda yönetmelink

Kurumsal ve bayi hesapları, kısıtlanan son kullanıcıları ve son 7 güne ait ret nedenlerini API konsolunun “Son kullanıcılar” sekmesinde inceleyebilir, hız limitini veya duraklatmayı kendileri kaldırabilir. Her son kullanıcı için bu işlem 24 saatte bir kez yapılabilir; tüm modellerde duraklatılmış bir son kullanıcı için yine destek ekibi gerekir. Sekmeyi etkinleştirmek için destek ekibiyle iletişime geçin.

Geçersiz değerlerlink

Geçersiz bir değer (çok uzun, boşluk veya ASCII dışı karakter içeren ya da aynı istekte iki kez gönderilen başlık) başlık hiç yokmuş gibi ele alınır: istek normal şekilde tamamlanır ve her API anahtarı günde bir uygulama içi hatırlatma alır.