joingonka.ai
लॉग इन करें

AI एजेंट्स के लिए: सेटअप की चरण-दर-चरण गाइड — /docs/agents.md, दस्तावेज़ इंडेक्स — /llms.txt।

एरर और सीमाएँ

गेटवे की अनुरोध सीमाएँ, टाइमआउट और त्रुटि कोड। हर रिस्पॉन्स के लिए बताया गया है कि वह कब होता है और क्या करना है: अनुरोध दोहराएँ या उसे ठीक करें।

सीमाएँ#

संख्याएँ — जवाब GET /v1/capabilities के फ़ील्ड limits से: वहाँ हमेशा मौजूदा मान रहते हैं।

सीमामानपार होने पर
प्रति की प्रति मिनट अनुरोध120, पहले अनुरोध से 60 सेकंड की विंडो429 rate_limit_exceeded और हेडर Retry-After; गेटवे की 5xx अस्वीकृतियाँ कोटा नहीं खर्च करतीं
अकाउंट के समवर्ती अनुरोधसीमितअतिरिक्त कतार में इंतज़ार करते हैं; बारी न आई तो — 429 queue_timeout
अनुरोध बॉडी का आकार16 MiB413
जवाब की लंबाईमॉडल के अनुसार — नीचे टेबलमॉडल की ऊपरी सीमा से ज़्यादा — बिना एरर के सीमा तक काट दिया जाता है
चाइल्ड कीप्रति मैनेजर की 50 तक, हर एक के लिए प्रति मिनट 120 अनुरोध तकसीमाएँ बढ़ाना — सपोर्ट के ज़रिए

मॉडल के अनुसार जवाब की लंबाई#

max_tokens के बिना गेटवे डिफ़ॉल्ट लगाता है: बिना स्ट्रीम — छोटा, ताकि जवाब टाइमआउट में रहे, स्ट्रीम में — मॉडल की ऊपरी सीमा। max_completion_tokens — वही फ़ील्ड।

modelऊपरी सीमाबिना स्ट्रीमस्ट्रीम में
MiniMaxAI/MiniMax-M2.7819215008192
deepseek-ai/DeepSeek-V4-Flash-073132768150032768
zai-org/GLM-5.3-Flash819230008192

टाइमआउट#

चरणमानक्या होता है
कतार में जगह का इंतज़ार45 सेहेडर Retry-After: 1 के साथ 429 queue_timeout
नेटवर्क जवाब की शुरुआत, स्ट्रीम150 से504 upstream_timeout; इनपुट टोकन का अनुमानित शुल्क काटा जाता है
नेटवर्क जवाब की शुरुआत, बिना स्ट्रीम150 से504 upstream_timeout; इनपुट टोकन का अनुमानित शुल्क काटा जाता है
जवाब जनरेट करना≈ 300 सेनेटवर्क जनरेशन बीच में रोक देता है: जवाब finish_reason: length के साथ आता है — अगले अनुरोध से जारी रखें
स्ट्रीम चंक के बीच पॉज़30 सेस्ट्रीम बंद हो जाती है: चंक joingonka-stream-stalled में finish_reason: stop
स्ट्रीम में एक्टिविटी सिग्नल15 सेकमेंट : keep-alive — SSE क्लाइंट इसे छोड़ देते हैं
स्ट्रीम खोलना30 सेइस क्षण तक अस्वीकृति रिस्पॉन्स कोड के रूप में आती है, उसके बाद — चंक joingonka-error के रूप में
बिना स्ट्रीम जल्दी जवाब90 सेगेटवे 200 लौटाता है और हर 15 से पर स्पेस भेजता है — JSON वैध बना रहता है; इसके बाद की एरर बॉडी में error फ़ील्ड के साथ आती है, स्टेटस 200 ही रहता है

टाइमआउट पर क्या कटता है

नेटवर्क द्वारा स्वीकार किए गए अनुरोध को रद्द नहीं किया जा सकता। 504 upstream_timeout पर इनपुट टोकन का अनुमान काटा जाता है, आउटपुट का नहीं; दोबारा भेजने पर नया शुल्क लगेगा। अंतिम usage से पहले टूटी स्ट्रीम का बिल भी वैसा ही लगता है। लंबे जवाबों के लिए stream: true के साथ अनुरोध करें।

एरर कोड#

एरर का बॉडी एक ऑब्जेक्ट error होता है जिसमें message, type, code, param फ़ील्ड होते हैं; हर एरर में सभी फ़ील्ड नहीं होते। स्टेटस और type को देखें, code से पुष्टि करें: message का टेक्स्ट बदल सकता है। Anthropic फ़ॉर्मैट — Anthropic एरर फ़ॉर्मैट सेक्शन में।

JSON
{
  "error": {
    "message": "Model is currently overloaded in the Gonka network",
    "type": "rate_limit_exceeded",
    "code": "upstream_rate_limited"
  }
}
जवाबकबक्या करें
400 invalid_request_errorगलत बॉडी: messages नहीं है, मैसेज ऑब्जेक्ट नहीं है, बॉडी JSON नहीं है; अज्ञात मॉडल — param के साथ: model और टेक्स्ट में उपलब्ध मॉडलों की सूचीएरर के टेक्स्ट के अनुसार अनुरोध ठीक करें
400 invalid_request_error empty_content_after_normalizationनॉर्मलाइज़ेशन के बाद मैसेज खाली है — जैसे उसमें सिर्फ़ एक इमेज थीमैसेज में टेक्स्ट जोड़ें
400 invalid_request_error web_search_privacy_sanitization_not_supportedएक ही अनुरोध में web और privacy-sanitization प्लगिनइनमें से एक रखें
400 invalid_request_error previous_response_id_not_supported conversation_not_supported item_reference_not_supported background_not_supported hosted_tool_choice_not_supportedOpenAI Responses: सेव किए गए जवाब, डायलॉग या आइटम का रेफ़रेंस; बैकग्राउंड मोड; बिल्ट-इन टूल की शर्तपूरी हिस्ट्री input में भेजें
400 api_errorनेटवर्क ने पैरामीटर अस्वीकार कर दिए — जैसे reasoning_effort की वैल्यू उसकी सूची में नहीं हैएरर के टेक्स्ट के अनुसार वैल्यू ठीक करें
401 authentication_errorकी नहीं मिली, रद्द कर दी गई या उसका फ़ॉर्मैट अज्ञात हैgate.joingonka.ai/keys पेज पर की जाँच करें
402 insufficient_fundsअनुरोध के अनुमान के लिए बैलेंस कम है; बची राशि — balance_ngonka मेंबैलेंस टॉप अप करें: gate.joingonka.ai/billing
402 insufficient_fundsबिना की वाला अनुरोध साइट से नहीं है (is_demo: true)API की भेजें
402 child_key_limit_exceededकी की खर्च सीमा पार हो गई — दैनिक, मासिक या कुल; बची राशि — daily_remaining, monthly_remaining, total_remaining मेंgate.joingonka.ai/keys पेज पर की की सीमा बढ़ाएँ या रीसेट का इंतज़ार करें
403 forbiddenमॉडल के अनुरोध में मैनेजमेंट की gm-; सिर्फ़ डैशबोर्ड वाले रूट पर API कीअनुरोधों के लिए jg- या gc- की इस्तेमाल करें; अकाउंट मैनेजमेंट — डैशबोर्ड में
404 invalid_request_error model_not_foundGET /v1/models/{model}: मॉडल कैटलॉग में नहीं है या उसे अस्थायी रूप से छिपाया गया हैGET /v1/models से id लें
404 invalid_request_error not_found compact_not_supportedOpenAI Responses: /v1/responses/{id} और स्टेट के अन्य पते, /v1/responses/compactहिस्ट्री अपने पास रखें; Codex CLI के लिए अपना प्रोवाइडर id सेट करें
404 invalid_request_errorअज्ञात पाथमेथड, पाथ और बेस अड्रेस जाँचें
413 invalid_request_errorअनुरोध की बॉडी लिमिट से बड़ी हैअनुरोध छोटा करें
415 invalid_request_errorहेडर के अनुसार बॉडी JSON नहीं है: Content-Type: application/json चाहिएContent-Type: application/json भेजें
429 rate_limit_exceededकी पर प्रति मिनट अनुरोधों की संख्या पार हो गई; बॉडी में — limit, remaining, reset के साथ rate_limitRetry-After में जितने सेकंड हैं उतना इंतज़ार करें
429 rate_limit_exceeded upstream_rate_limitedGonka नेटवर्क में मॉडल ओवरलोडेड हैRetry-After के बाद दोबारा भेजें या दूसरा मॉडल लें — मॉडल्स
429 rate_limit_exceeded queue_timeout queue_fullनेटवर्क की सभी जगहें भरी हैं: कतार पूरी है या इंतज़ार का समय खत्म हो गयाRetry-After के बाद दोबारा भेजें
500 server_errorगेटवे की आंतरिक गड़बड़ीबाद में दोबारा भेजें; बार-बार हो रहा हो — सपोर्ट को लिखें और x-request-id संलग्न करें
501 not_implementedPOST /v1/embeddings: नेटवर्क में कोई embedding मॉडल नहीं हैकोई दूसरी embedding सेवा लें
502 api_error upstream_unauthorizedनेटवर्क के प्रोवाइडर ने गेटवे के क्रेडेंशियल अस्वीकार कर दिए — आपकी की ठीक हैएक मिनट बाद दोबारा भेजें
502 api_errorGonka नेटवर्क की गड़बड़ी; code — नेटवर्क से, अगर उसने भेजा होपॉज़ के साथ दोबारा भेजें या दूसरा मॉडल लें
503 model_unavailable model_outage model_initializing model_unstable model_not_servedनेटवर्क की जाँच के अनुसार मॉडल अभी उपलब्ध नहीं है: खराबी, शुरू हो रहा है, अस्थिरता या उसे कोई सर्व नहीं कर रहा; इनकार तुरंत, बिना इंतज़ारदूसरा मॉडल लें — एरर का टेक्स्ट बताएगा कौन-सा; सूची — मॉडल्स
503 service_unavailableकोई उपलब्ध नोड नहीं हैबाद में दोबारा भेजें
504 timeout upstream_timeoutनेटवर्क ने अनुरोध स्वीकार किया, लेकिन समय पर जवाब नहीं दिया; इनपुट टोकन का अनुमान काट लिया गयालंबे जवाबों के लिए — stream: true; दोबारा भेजने पर नया शुल्क

खुली स्ट्रीम में एरर#

जब तक स्ट्रीम खुली नहीं होती, इनकार सामान्य रिस्पॉन्स कोड के साथ आता है — जैसे स्ट्रीमिंग के बिना। खुलने के बाद स्टेटस 200 होता है, और एरर इस तरह आता है:

  • Chat Completions — error फ़ील्ड वाला joingonka-error चंक, फिर [DONE] के बिना कटाव।
  • स्ट्रीमिंग के बिना, जल्दी मिले जवाब के बाद — स्टेटस 200 और error फ़ील्ड वाली बॉडी।
  • Anthropic Messages — event: error इवेंट, फिर स्ट्रीम बंद हो जाती है।
  • OpenAI Responses — response.failed इवेंट, वजह response.error.code में।
  • Legacy Completions — data: {"error": …}, फिर [DONE]।
SSE
data: {"id":"joingonka-error","object":"chat.completion.chunk","model":"MiniMaxAI/MiniMax-M2.7","choices":[],"error":{"message":"Gonka network error","type":"api_error"}}

Anthropic एरर फ़ॉर्मैट#

  • POST /v1/messages Anthropic लिफ़ाफ़े में जवाब देता है: {"type": "error", "error": {"type", "message"}}।
  • गेटवे के इनकार ऊपर की टेबल से type बनाए रखते हैं (insufficient_funds, model_unavailable और अन्य); इस लिफ़ाफ़े में code फ़ील्ड नहीं होता — वजह टेक्स्ट में है।
  • अनुरोध के फ़ॉर्म की गड़बड़ियाँ — invalid_request_error: मैसेज या max_tokens नहीं है, नाम के बिना टूल कॉल, अज्ञात मॉडल।
  • अज्ञात पाथ — not_found_error, बहुत बड़ी बॉडी — request_too_large।
SSE
event: error
data: {"type":"error","error":{"type":"timeout","message":"Upstream timeout"}}

क्या दोबारा भेजें#

  • Retry-After से मिले पॉज़ के बाद: 429
  • बढ़ते पॉज़ के साथ — 1, 2, 4 सेकंड और आगे: 500, 502, 503 service_unavailable, 504
  • दूसरे मॉडल के साथ: 503 model_unavailable
  • बिना बदलाव दोबारा न भेजें — अनुरोध, की या बैलेंस ठीक करें: 400, 401, 402, 403, 404, 413, 415, 501

504 के बाद हर दोबारा भेजने पर इनपुट के अनुमान का नया शुल्क लगता है; लंबे जवाबों के लिए stream: true चालू करें।

एरर बार-बार आ रहा हो — सपोर्ट को लिखें और रिस्पॉन्स हेडर से x-request-id संलग्न करें।