{"title":"रेट लिमिट और कोटा","slug":"rate-limits","category":"api","summary":"Synapse API के लिए रेट लिमिट नीति — Bearer हेडर (असीमित), ?key= (60/min), सार्वजनिक एंडपॉइंट्स।","audience":["human","llm"],"tags":["api","rate-limits","quotas","throttling"],"difficulty":"beginner","updated":"2026-06-27","word_count":389,"read_minutes":2,"llm_context":"Mind Key (Authorization: Bearer header) → NO rate limit\nMind Key (?key= query param) → 60 req/min per IP\nJWT (Authorization: Bearer header) → NO rate limit\nPublic endpoints (/tools/*, /docs, /health, /endpoints) → NO rate limit\nRate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After\nRecommendation: ALWAYS use Authorization header. Use ?key= only for URL-only tools.\n","lang":"hi","translated":true,"requested_lang":"hi","content_markdown":"\n# रेट लिमिट और कोटा\n\nSynapse में एक सरल, अनुमानित रेट लिमिट नीति है जो दुरुपयोग को रोकने के लिए डिज़ाइन की गई है जबकि वैध उपयोग के रास्ते में नहीं आती।\n\n## रेट लिमिट नीति\n\n| प्रमाणीकरण विधि | सीमा | दायरा |\n|-------------|-------|-------|\n| Mind Key (`Authorization: Bearer`) | **कोई नहीं** | प्रति-mind |\n| Mind Key (`?key=`) | 60 req/min | प्रति-IP |\n| JWT (`Authorization: Bearer`) | **कोई नहीं** | प्रति-उपयोगकर्ता |\n| सार्वजनिक एंडपॉइंट्स | **कोई नहीं** | वैश्विक |\n\n> [!TIP]\n> **संभव होने पर हमेशा `Authorization: Bearer` हेडर का उपयोग करें।** इसकी कोई रेट लिमिट नहीं है। `?key=` का उपयोग केवल उन टूल्स के लिए करें जो कस्टम हेडर सेट नहीं कर सकते।\n\n## रेट लिमिट हेडर\n\nजब आप `?key=` प्रमाणीकरण का उपयोग करते हैं, तो प्रतिक्रियाएँ रेट लिमिट हेडर शामिल करती हैं:\n\n```\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840\n```\n\nजब आप सीमा पार करते हैं:\n\n```\nHTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n \"statusCode\": 429,\n \"error\": \"Too Many Requests\",\n \"message\": \"Rate limit exceeded. Use Authorization header for unlimited access.\"\n}\n```\n\n## जब आप रेट लिमिट हिट करते हैं\n\nयदि आपको 429 मिलता है:\n\n1. **Authorization हेडर पर स्विच करें** (अनुशंसित):\n ```bash\n # Don't: ?key=YOUR_MIND_KEY (60/min limit)\n curl \".../memory/recall?key=YOUR_MIND_KEY\"\n \n # Do: Authorization header (unlimited)\n curl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n ```\n\n2. **या `Retry-After` सेकंड प्रतीक्षा करें** और पुनः प्रयास करें।\n\n## ?key= सीमा क्यों मौजूद है\n\n`?key=` क्वेरी पैरामीटर URL-केवल टूल्स (ब्राउज़र, `open` कमांड) के लिए सुविधाजनक है, लेकिन इसके सुरक्षा और प्रदर्शन निहितार्थ हैं:\n\n- **सुरक्षा:** क्वेरी पैरामीटर सर्वर एक्सेस लॉग, ब्राउज़र इतिहास, और Referer हेडर में लॉग किए जाते हैं। उपयोग को सीमित करने से जोखिम कम होता है।\n- **प्रदर्शन:** क्वेरी-पैरामीटर प्रमाणीकरण के लिए IP-आधारित रेट लिमिटर की आवश्यकता होती है (प्रति अनुरोध Redis लुकअप), जो विलंबता जोड़ता है। हेडर प्रमाणीकरण इसे छोड़ देता है।\n- **दुरुपयोग निवारण:** लीक हुई `?key=` URL साझा और हैमर की जा सकती है। IP सीमा प्रभाव की दायरा सीमित रखती है।\n\n## अनुशंसित पैटर्न\n\n### LLM एजेंट्स\n\n```python\n# Always use header auth\nheaders = {\"Authorization\": f\"Bearer {MIND_KEY}\"}\nresponse = requests.get(f\"{URL}/memory/recall\", headers=headers)\n```\n\n### ब्राउज़र-आधारित टूल्स\n\nयदि आपका टूल केवल URL खोल सकता है:\n\n```bash\n# OK for occasional use (under 60/min)\nopen \"https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY\"\n\n# For frequent use, switch to a tool that supports headers\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" .../memory/recall\n```\n\n### MCP server\n\nMCP servers हमेशा `SYNAPSE_MIND_KEY` env var के माध्यम से हेडर प्रमाणीकरण का उपयोग करते हैं — कोई रेट लिमिट लागू नहीं होती।\n\n### बल्क आयात\n\nबल्क ऑपरेशन्स (जैसे 1000 मेमोरीज़ आयात करना) के लिए, हमेशा हेडर प्रमाणीकरण का उपयोग करें। `?key=` के माध्यम से बल्क आयात 1 मिनट के भीतर रेट लिमिट हिट करेगा।\n\n## कोटा (Mind-स्तर)\n\nवर्तमान में स्टोरेज आकार या मेमोरी गिनती पर कोई प्रति-mind कोटा नहीं है। सभी सीमाएँ डेटा स्तर पर नहीं, बल्कि प्रमाणीकरण/IP स्तर पर हैं। यह भविष्य में मल्टी-टैनेंट निष्पक्षता के लिए बदल सकता है।\n\n## अपने उपयोग की निगरानी\n\n```bash\n# Check your current rate limit status (with ?key= auth)\ncurl -i \"https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY\" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840\n```\n\n## अगले कदम\n\n- [प्रमाणीकरण](/docs/getting-started/authentication)\n- [त्रुटियाँ और त्रुटि प्रबंधन](/docs/api/errors)\n","content_html":"

रेट लिमिट और कोटा

\n

Synapse में एक सरल, अनुमानित रेट लिमिट नीति है जो दुरुपयोग को रोकने के लिए डिज़ाइन की गई है जबकि वैध उपयोग के रास्ते में नहीं आती।

\n

रेट लिमिट नीति

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
प्रमाणीकरण विधिसीमादायरा
Mind Key (Authorization: Bearer)कोई नहींप्रति-mind
Mind Key (?key=)60 req/minप्रति-IP
JWT (Authorization: Bearer)कोई नहींप्रति-उपयोगकर्ता
सार्वजनिक एंडपॉइंट्सकोई नहींवैश्विक
\n
**संभव होने पर हमेशा `Authorization: Bearer` हेडर का उपयोग करें।** इसकी कोई रेट लिमिट नहीं है। `?key=` का उपयोग केवल उन टूल्स के लिए करें जो कस्टम हेडर सेट नहीं कर सकते।

रेट लिमिट हेडर

\n

जब आप ?key= प्रमाणीकरण का उपयोग करते हैं, तो प्रतिक्रियाएँ रेट लिमिट हेडर शामिल करती हैं:

\n
X-RateLimit-Limit: 60\nX-RateLimit-Remaining: 42\nX-RateLimit-Reset: 1782567840

जब आप सीमा पार करते हैं:

\n
HTTP/1.1 429 Too Many Requests\nX-RateLimit-Limit: 60\nX-RateLimit-Remaining: 0\nRetry-After: 42\nContent-Type: application/json\n\n{\n  "statusCode": 429,\n  "error": "Too Many Requests",\n  "message": "Rate limit exceeded. Use Authorization header for unlimited access."\n}

जब आप रेट लिमिट हिट करते हैं

\n

यदि आपको 429 मिलता है:

\n
    \n

  1. Authorization हेडर पर स्विच करें (अनुशंसित):

    \n
    # Don't: ?key=YOUR_MIND_KEY (60/min limit)\ncurl ".../memory/recall?key=YOUR_MIND_KEY"\n\n# Do: Authorization header (unlimited)\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall
    2. \n

  2. या Retry-After सेकंड प्रतीक्षा करें और पुनः प्रयास करें।

    \n
    3. \n
\n

?key= सीमा क्यों मौजूद है

\n

?key= क्वेरी पैरामीटर URL-केवल टूल्स (ब्राउज़र, open कमांड) के लिए सुविधाजनक है, लेकिन इसके सुरक्षा और प्रदर्शन निहितार्थ हैं:

\n\n

अनुशंसित पैटर्न

\n

LLM एजेंट्स

\n
# Always use header auth\nheaders = {"Authorization": f"Bearer {MIND_KEY}"}\nresponse = requests.get(f"{URL}/memory/recall", headers=headers)

ब्राउज़र-आधारित टूल्स

\n

यदि आपका टूल केवल URL खोल सकता है:

\n
# OK for occasional use (under 60/min)\nopen "https://synapse.schaefer.zone/memory/recall?key=YOUR_MIND_KEY"\n\n# For frequent use, switch to a tool that supports headers\ncurl -H "Authorization: Bearer YOUR_MIND_KEY" .../memory/recall

MCP server

\n

MCP servers हमेशा SYNAPSE_MIND_KEY env var के माध्यम से हेडर प्रमाणीकरण का उपयोग करते हैं — कोई रेट लिमिट लागू नहीं होती।

\n

बल्क आयात

\n

बल्क ऑपरेशन्स (जैसे 1000 मेमोरीज़ आयात करना) के लिए, हमेशा हेडर प्रमाणीकरण का उपयोग करें। ?key= के माध्यम से बल्क आयात 1 मिनट के भीतर रेट लिमिट हिट करेगा।

\n

कोटा (Mind-स्तर)

\n

वर्तमान में स्टोरेज आकार या मेमोरी गिनती पर कोई प्रति-mind कोटा नहीं है। सभी सीमाएँ डेटा स्तर पर नहीं, बल्कि प्रमाणीकरण/IP स्तर पर हैं। यह भविष्य में मल्टी-टैनेंट निष्पक्षता के लिए बदल सकता है।

\n

अपने उपयोग की निगरानी

\n
# Check your current rate limit status (with ?key= auth)\ncurl -i "https://synapse.schaefer.zone/memory/stats?key=YOUR_MIND_KEY" | grep -i ratelimit\n\n# Output:\n# X-RateLimit-Limit: 60\n# X-RateLimit-Remaining: 58\n# X-RateLimit-Reset: 1782567840

अगले कदम

\n\n","urls":{"html":"/docs/api/rate-limits","text":"/docs/api/rate-limits?format=text","json":"/docs/api/rate-limits?format=json","llm":"/docs/api/rate-limits?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}