चेंजलॉग
Shannon API के हाल के अपडेट और सुधार।
यह पेज वे बदलाव सूचीबद्ध करता है जो API के कॉलर के रूप में आप देख सकते हैं: नए endpoints, फ़ील्ड और मॉडल, बदला हुआ व्यवहार और सुधार। सबसे नई प्रविष्टियाँ पहले आती हैं। हर प्रविष्टि में बदलाव की तारीख़ होती है।
ब्रेकिंग चिह्नित प्रविष्टि पहले चलने वाले अनुरोध का परिणाम बदल सकती है। API का एक ही संस्करण है, /v1, इसलिए बदलाव संस्करण संख्या से नहीं, तारीख़ से सूचीबद्ध हैं।
- नया
web_search: trueवाला अनुरोध अपने स्रोत बताता है:/v1/chat/completionsऔर/v1/messagesपरsourcesमॉडल को दिए गए परिणामों की सूची देता है, और/v1/chat/completionsपरannotationsदिखाता है कि उत्तर हर एक का हवाला कहाँ देता है। इनबिल्ट Web Search
- नया
/v1/chat/completionsऔर/v1/messagesपरweb_search: trueमॉडल के उत्तर देने से पहले वेब सर्च चलाता है और परिणाम क्रमांकित स्रोतों के रूप में उसे देता है। जिस अनुरोध को परिणाम मिले, वह आपके दैनिक अलाउंस की एक सर्च उपयोग करता है। कोई बची न हो तो अनुरोध बिना सर्च के उत्तर पाता है। इनबिल्ट Web Search
- ठीक किया गया
सर्वर की ओर से काटी गई स्ट्रीम का बिल उस बिंदु तक बताए गए उपयोग के लिए बनता है। रिज़र्वेशन का बाकी हिस्सा आपके बैलेंस में लौट जाता है।
- ठीक किया गया
shannon-coder-1/v1/responsesपर वैसे ही उत्तर देता है जैसे बाकी दो endpoints पर। CLI कोडिंग टूल्स - ठीक किया गया
रोटेट की गई API key तुरंत काम करना बंद कर देती है।
- नया
POST /v1/tokenizeऔरPOST /v1/messages/count_tokens: होस्टेड ओपन-वेट मॉडल के लिए मुफ़्त टोकन गिनती। टोकन गिनती - नया
होस्टेड ओपन-वेट मॉडल पर प्रॉम्प्ट कैशिंग। कैश्ड इनपुट का बिल इनपुट कीमत के 25% पर बनता है और तीनों endpoints पर
usageमें बताया जाता है:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensऔरcache_read_input_tokens।GET /v1/modelsइन मॉडल के लिएpricing.cached_input_per_million_usdऔरcapabilities.prompt_cachingबताता है। प्रॉम्प्ट कैशिंग - ठीक किया गया
होस्टेड ओपन-वेट मॉडल: ज़बरदस्ती वाला
tool_choice(requiredया कोई नामित फ़ंक्शन) एक टूल कॉल देता है। फ़ंक्शन कॉलिंग - ठीक किया गया
होस्टेड ओपन-वेट मॉडल ऐसा
systemसंदेश स्वीकार करते हैं जो बातचीत का पहला संदेश नहीं है।
- नया
API एक Tor onion सेवा के रूप में और एक I2P पते पर उपलब्ध है।
api.shannon-ai.comके उत्तर दोनों पतेOnion-LocationऔरX-I2P-Locationहेडर में ले जाते हैं। एन्क्रिप्टेड, Tor और I2P endpoints
- नया
नए मॉडल
shannon-3.1औरshannon-3.1-pro, जोGET /v1/modelsमें सूचीबद्ध हैं। मॉडल और कीमतें - बदला गया
जिस स्ट्रीम वाले अनुरोध का क्लाइंट डिस्कनेक्ट हो जाता है, वह अपने अंत तक चलता है और गिना जाता है। पहले उत्तर डिस्कनेक्ट पर रुक जाता था।
- ठीक किया गया
/v1/responsesके अनुरोध उपयोग लॉग में दिखते हैं।
- नया
होस्टेड ओपन-वेट मॉडल सैंपलिंग फ़ील्ड लागू करते हैं:
/v1/chat/completionsपरtemperature,top_p,seed,stopऔरmax_tokens;/v1/messagesपरtemperature,top_pऔरstop_sequences;/v1/responsesपरtemperature,top_pऔरmax_output_tokens। Chat Completions - नया
उपयोग लॉग हर कॉल की और कुल लागत USD में दिखाता है।
- ब्रेकिंग
प्रकाशित id न होने वाले
modelमान का उत्तर तीनों endpoints पर400, प्रकारinvalid_request_errorऔर संदेशunknown model: <id>से दिया जाता है। पहले ऐसे अनुरोध का उत्तरshannon-1.6-liteदेता था। मॉडल और कीमतें - ब्रेकिंग
/v1केवल API key लेता है। वेबसाइट की साइन-इन कुकी वहाँ नहीं पढ़ी जाती। प्रमाणीकरण - बदला गया
Flood protection: तीनों जनरेशन endpoints पर प्रति अकाउंट प्रति मिनट 120 अनुरोध। सीमाएँ और बैलेंस
- बेहतर किया गया
जब मॉडल उत्तर नहीं दे पाता, तो त्रुटि में तय संदेश
The model backend failed to answer. Please retry.होता है। जो बैलेंस जाँच नहीं हो पाती उसका उत्तर503और प्रकारapi_errorसे दिया जाता है। त्रुटि प्रबंधन - ठीक किया गया
बिना स्ट्रीम वाला जो अनुरोध विफल होता है, वह अपना रिज़र्वेशन आपके बैलेंस में लौटा देता है।
- नया
GET /v1/modelsहर मॉडल के लिएcapabilities.reasoning_effortबताता है। रीज़निंग effort - बेहतर किया गया
होस्टेड ओपन-वेट मॉडल: बिना स्ट्रीम वाला अनुरोध जिसे कोई उत्तर नहीं मिलता,
504और प्रकारapi_errorके साथ समाप्त होता है। खाली परिणाम502है। त्रुटि प्रबंधन
- ब्रेकिंग
होस्टेड ओपन-वेट मॉडल वही इनपुट लेते हैं जो नामित मॉडल लेता है। केवल-टेक्स्ट id को भेजी गई इमेज का उत्तर
400और<id> does not accept image inputसे दिया जाता है। संरचित आउटपुट के बिना id परresponse_formatका उत्तर400से दिया जाता है।GET /v1/modelsहर id के लिएcapabilities.vision,response_formatऔरjson_schemaबताता है। इमेज और फ़ाइलें - ठीक किया गया
बिना स्ट्रीम वाले उत्तर रीज़निंग टेक्स्ट ले जाते हैं:
/v1/chat/completionsके संदेश परreasoning_content, और/v1/messagesपर टेक्स्ट से पहले एकthinkingब्लॉक। रीज़निंग effort - बदला गया
होस्टेड ओपन-वेट मॉडल की नई कीमतें हैं, $0.50 प्रति 1M इनपुट टोकन और $2.00 प्रति 1M आउटपुट टोकन से शुरू। मॉडल और कीमतें
- बदला गया
होस्टेड ओपन-वेट मॉडल का हर मॉडल के लिए एक id है, कुल बारह id। मॉडल और कीमतें
- नया
shannon-3,shannon-3-pro,shannon-3.1औरshannon-3.1-proपर संरचित आउटपुट।GET /v1/modelsइनके लिएcapabilities.json_schema: trueबताता है। संरचित आउटपुट - नया
/v1/responsesसंरचित आउटपुट के लिएtext.format(json_objectयाjson_schema) पढ़ता है। Responses API - ठीक किया गया
/v1/responsesShannon मॉडल की रीज़निंग लौटाता है:messageआइटम से पहले एकreasoningआउटपुट आइटम, और स्ट्रीम इवेंटresponse.reasoning_summary_text.deltaऔरresponse.reasoning_summary_text.done। Responses API - ठीक किया गया
उत्तर का
modelफ़ील्ड हर endpoint पर प्रकाशित id होता है। Responses ऑब्जेक्टmodelऔरcreated_atले जाता है। - बेहतर किया गया
GET /v1/modelsहर मॉडल की कॉन्टेक्स्ट विंडो बताता है। मॉडल और कीमतें
- नया
होस्टेड ओपन-वेट मॉडल
/v1/chat/completionsके साथ-साथ/v1/messagesऔर/v1/responsesपर भी, आपके सिस्टम प्रॉम्प्ट और टूल कॉल के साथ उत्तर देते हैं।/v1/messagesthinkingलेता है, औरreasoning_effortएक अनुरोध फ़ील्ड है। मॉडल और कीमतें - बेहतर किया गया
/v1पर त्रुटि बॉडी SDK के रूपों का पालन करती हैं: OpenAI-फ़ॉर्मेट endpoints परtypeऔरmessageके साथ एकerrorऑब्जेक्ट, और/v1/messagesपर वही ऑब्जेक्ट{"type": "error"}के भीतर। त्रुटि प्रबंधन - नया
खुली स्ट्रीम पर हर 15 सेकंड में keep-alive:
/v1/chat/completionsपर एक: pingकमेंट लाइन,/v1/messagesपर एकevent: ping। स्ट्रीमिंग - बदला गया
टूल कॉल id
/v1/chat/completionsऔर/v1/responsesपरcall_से और/v1/messagesपरtoolu_से शुरू होते हैं। फ़ंक्शन कॉलिंग - ब्रेकिंग
/v1/responses:streamका डिफ़ॉल्टfalseहै। Responses API - नया
/v1/chat/completionsपरmax_completion_tokensकोmax_tokensके दूसरे नाम के रूप में स्वीकार किया जाता है। Chat Completions - ठीक किया गया
Responses स्ट्रीम का
response.completedइवेंटoutputऐरे ले जाता है। Responses API - नया
GET /v1/modelsकी प्रविष्टियाँdisplay_name,context_window,max_output_tokens,pricing,capabilitiesऔरendpointsले जाती हैं। मॉडल और कीमतें - नया
हर उत्तर
x-request-idले जाता है, और आपका भेजा मान लौटाया जाता है। अनुरोध बॉडी 32 MiB तक हो सकती हैं। - नया
बिना नई key जारी किए भी key रद्द की जा सकती है। उपयोग लॉग पेजों में बँटा है।
- नया
अनुरोधों में इमेज और दस्तावेज़:
/v1/chat/completionsपरimage_urlभाग,/v1/messagesपरimage,documentऔरfileब्लॉक,/v1/responsesपरinput_imageभाग। इमेज और फ़ाइलें - नया
नया मॉडल
shannon-3-pro। मॉडल और कीमतें
- नया
नया मॉडल
shannon-3। मॉडल और कीमतें - नया
/v1/chat/completionsकी स्ट्रीम रीज़निंग कोdelta.reasoning_contentके रूप में ले जाती हैं। रीज़निंग effort
- बदला गया
max_tokensको 1 से 65,536 के भीतर रखा जाता है। उस सीमा के बाहर का मान अस्वीकार नहीं किया जाता, निकटतम छोर पर ला दिया जाता है। Chat Completions
- नया
/v1/chat/completionsऔर/v1/messagesपरshannon-coder-1को प्लान के अनुसार कॉल में गिना जाता है। जब किसी विंडो की कॉल समाप्त हो जाती हैं, तो उत्तर429होता है और संदेशShannon Coder call quota reachedहोता है। CLI कोडिंग टूल्स - नया
कॉन्टेक्स्ट विंडो से बड़ी बातचीत का उत्तर
400, प्रकारinvalid_request_errorऔर कोडcontext_length_exceededसे दिया जाता है। स्ट्रीम के भीतर की त्रुटि उत्तर में टेक्स्ट के रूप में नहीं, एक error इवेंट के रूप में आती है। CLI कोडिंग टूल्स
- नया
/v1endpoints:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesऔरGET /v1/models। ये वे endpoints हैं जिन्हें OpenAI और Anthropic SDK, Claude Code और Codex CLI कॉल करते हैं। सारांश - नया
/v1/chat/completionsऔर/v1/messagesपरtoolsके साथ टूल कॉल,response_formatके साथ संरचित आउटपुट, और/v1/messagesपरsystemस्ट्रिंग या टेक्स्ट ब्लॉक के रूप में। फ़ंक्शन कॉलिंग
- नया
मॉडल id
shannon-1.6-pro,shannon-2-lite,shannon-2-proऔरshannon-coder-1,shannon-1.6-liteके साथ। मॉडल और कीमतें
- नया
API की पहली रिलीज़: OpenAI फ़ॉर्मेट और Anthropic फ़ॉर्मेट में चैट, और एक Responses endpoint, हर एक को
sk-से शुरू होने वाली API key से कॉल किया जाता है। प्रमाणीकरण