बदल नोंद
Shannon API साठी अलीकडील अपडेट्स आणि सुधारणा.
हे पान API चे कॉलर म्हणून तुम्हाला दिसू शकणारे बदल सांगते: नवीन एंडपॉइंट, फील्ड्स आणि मॉडेल्स, बदललेले वर्तन आणि दुरुस्त्या. सर्वात नव्या नोंदी आधी येतात. प्रत्येक नोंदीत बदल केल्याची तारीख असते.
ब्रेकिंग म्हणून चिन्हांकित नोंद आधी चालणाऱ्या रिक्वेस्टचा निकाल बदलू शकते. API ची एकच आवृत्ती आहे, /v1, त्यामुळे बदल आवृत्ती क्रमांकाने नव्हे तर तारखेनुसार दिले आहेत.
- नवीन
web_search: trueअसलेली रिक्वेस्ट आपले स्रोत सांगते:/v1/chat/completionsआणि/v1/messagesवरीलsourcesमॉडेलला दिलेले निकाल यादीत देते, आणि/v1/chat/completionsवरीलannotationsउत्तर प्रत्येकाचा उल्लेख कुठे करते ते दाखवतात. Built‑in Web Search
- नवीन
/v1/chat/completionsआणि/v1/messagesवरीलweb_search: trueमॉडेल उत्तर देण्यापूर्वी वेब सर्च चालवतो आणि निकाल क्रमांकित स्रोत म्हणून त्याला देतो. निकाल सापडलेली रिक्वेस्ट तुमच्या दैनिक कोट्यातील एक सर्च वापरते. काहीही शिल्लक नसल्यास रिक्वेस्टला सर्चशिवाय उत्तर मिळते. Built‑in Web Search
- दुरुस्त
सर्व्हरच्या बाजूने तोडलेल्या स्ट्रीमचे बिल तिथपर्यंत सांगितलेल्या usage साठी होते. राखीव प्रमाणाचा उरलेला भाग तुमच्या बॅलन्समध्ये परत येतो.
- दुरुस्त
shannon-coder-1इतर दोन एंडपॉइंटप्रमाणेच/v1/responsesवरही उत्तर देते. CLI कोडिंग टूल्स - दुरुस्त
रोटेट केलेली API की लगेच चालणे थांबवते.
- नवीन
POST /v1/tokenizeआणिPOST /v1/messages/count_tokens: होस्ट केलेल्या open-weight मॉडेल्ससाठी मोफत टोकन मोजणी. टोकन मोजणी - नवीन
होस्ट केलेल्या open-weight मॉडेल्सवर प्रॉम्प्ट कॅशिंग. कॅश केलेल्या इनपुटचे बिल इनपुट किमतीच्या 25% दराने होते आणि तिन्ही एंडपॉइंटवर
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सांगतो. प्रॉम्प्ट कॅशिंग - दुरुस्त
होस्ट केलेली open-weight मॉडेल्स: सक्तीचा
tool_choice(requiredकिंवा नाव दिलेले फंक्शन) टूल कॉल देतो. फंक्शन कॉलिंग - दुरुस्त
होस्ट केलेली open-weight मॉडेल्स संभाषणातील पहिला संदेश नसलेला
systemसंदेश स्वीकारतात.
- नवीन
API Tor onion सेवा म्हणून आणि I2P पत्त्यावर उपलब्ध आहे.
api.shannon-ai.comची उत्तरे दोन्ही पत्तेOnion-LocationआणिX-I2P-Locationहेडरमध्ये देतात. एन्क्रिप्टेड, Tor आणि I2P एंडपॉइंट्स
- नवीन
नवीन मॉडेल्स
shannon-3.1आणिshannon-3.1-pro,GET /v1/modelsमध्ये यादीबद्ध. मॉडेल्स आणि किंमत - बदल
क्लायंट डिस्कनेक्ट होणारी स्ट्रीम रिक्वेस्ट शेवटपर्यंत चालते आणि मोजली जाते. पूर्वी डिस्कनेक्टवर उत्तर थांबत असे.
- दुरुस्त
/v1/responsesकडे जाणाऱ्या रिक्वेस्ट्स usage लॉगमध्ये दिसतात.
- नवीन
होस्ट केलेली open-weight मॉडेल्स सॅम्पलिंग फील्ड्स लागू करतात:
/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 - नवीन
usage लॉग प्रत्येक कॉलसाठी आणि एकूण बेरीज म्हणून USD मध्ये खर्च दाखवतो.
- ब्रेकिंग
जाहीर केलेला id नसलेल्या
modelव्हॅल्यूला तिन्ही एंडपॉइंटवर400, प्रकारinvalid_request_errorआणि संदेशunknown model: <id>सह उत्तर मिळते. पूर्वी अशा रिक्वेस्टलाshannon-1.6-liteउत्तर देत असे. मॉडेल्स आणि किंमत - ब्रेकिंग
/v1फक्त API की घेतो. वेबसाइटची साइन-इन कुकी तेथे वाचली जात नाही. प्रमाणीकरण - बदल
फ्लड प्रोटेक्शन: तिन्ही जनरेशन एंडपॉइंटवर प्रति अकाउंट प्रति मिनिट 120 रिक्वेस्ट्स. मर्यादा आणि बॅलन्स
- सुधारित
मॉडेल उत्तर देऊ शकत नसेल तेव्हा एरर निश्चित संदेश
The model backend failed to answer. Please retry.देतो. करता न आलेल्या बॅलन्स तपासणीला503आणि प्रकारapi_errorसह उत्तर मिळते. त्रुटी हाताळणी - दुरुस्त
अयशस्वी होणारी स्ट्रीम नसलेली रिक्वेस्ट आपले राखीव प्रमाण तुमच्या बॅलन्समध्ये परत देते.
- नवीन
GET /v1/modelsप्रत्येक मॉडेलसाठीcapabilities.reasoning_effortसांगतो. रीझनिंग effort - सुधारित
होस्ट केलेली open-weight मॉडेल्स: उत्तर न मिळणारी स्ट्रीम नसलेली रिक्वेस्ट
504आणि प्रकारapi_errorसह संपते. रिकामा निकाल502असतो. त्रुटी हाताळणी
- ब्रेकिंग
होस्ट केलेली open-weight मॉडेल्स नाव दिलेले मॉडेल जे इनपुट घेते तेच घेतात. फक्त-मजकूर 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 - बदल
होस्ट केलेल्या open-weight मॉडेल्सच्या किंमती नवीन आहेत, प्रति 1M इनपुट टोकन्स $0.50 आणि प्रति 1M आउटपुट टोकन्स $2.00 पासून. मॉडेल्स आणि किंमत
- बदल
होस्ट केलेल्या open-weight मॉडेल्सना प्रत्येक मॉडेलमागे एक id आहे, एकूण बारा id. मॉडेल्स आणि किंमत
- नवीन
shannon-3,shannon-3-pro,shannon-3.1आणिshannon-3.1-proवर स्ट्रक्चर्ड आउटपुट.GET /v1/modelsत्यांच्यासाठीcapabilities.json_schema: trueसांगतो. संरचित आउटपुट्स - नवीन
स्ट्रक्चर्ड आउटपुटसाठी
/v1/responsestext.format(json_objectकिंवाjson_schema) वाचतो. Responses API - दुरुस्त
/v1/responsesShannon मॉडेल्सचे रीझनिंग परत करतो:messageआयटमच्या आधीreasoningआउटपुट आयटम, आणि स्ट्रीम इव्हेंट्सresponse.reasoning_summary_text.deltaवresponse.reasoning_summary_text.done. Responses API - दुरुस्त
उत्तराचे
modelफील्ड प्रत्येक एंडपॉइंटवर जाहीर केलेला id असते. Responses ऑब्जेक्टmodelआणिcreated_atदेतो. - सुधारित
GET /v1/modelsप्रत्येक मॉडेलची कॉन्टेक्स्ट विंडो सांगतो. मॉडेल्स आणि किंमत
- नवीन
होस्ट केलेली open-weight मॉडेल्स
/v1/chat/completionsप्रमाणेच/v1/messagesआणि/v1/responsesवरही उत्तर देतात, तुमच्या सिस्टम प्रॉम्प्ट आणि टूल कॉल्ससह./v1/messagesthinkingघेतो, आणिreasoning_effortहे रिक्वेस्ट फील्ड आहे. मॉडेल्स आणि किंमत - सुधारित
/v1वरील एरर बॉडी SDK च्या रचनेनुसार असतात: OpenAI-फॉरमॅट एंडपॉइंटवर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_tokensचे दुसरे नाव म्हणूनmax_completion_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 पर्यंत असू शकतात. - नवीन
नवीन की न देता की रद्द करता येते. usage लॉग पानांमध्ये विभागलेला आहे.
- नवीन
रिक्वेस्ट्समध्ये इमेज आणि डॉक्युमेंट्स:
/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_tokens1 ते 65,536 च्या आत ठेवले जाते. त्या श्रेणीबाहेरची व्हॅल्यू नाकारली जात नाही, जवळच्या टोकावर आणली जाते. Chat Completions
- नवीन
shannon-coder-1/v1/chat/completionsआणि/v1/messagesवर प्रति प्लॅन कॉल्समध्ये मोजले जाते. विंडोचे कॉल्स संपल्यावर उत्तर429असते, संदेशShannon Coder call quota reachedसह. CLI कोडिंग टूल्स - नवीन
कॉन्टेक्स्ट विंडोपेक्षा मोठ्या संभाषणाला
400, प्रकारinvalid_request_errorआणि कोडcontext_length_exceededसह उत्तर मिळते. स्ट्रीममधील एरर उत्तरातील मजकूर म्हणून नव्हे, तर एरर इव्हेंट म्हणून येतो. CLI कोडिंग टूल्स
- नवीन
/v1एंडपॉइंट:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesआणिGET /v1/models. 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 एंडपॉइंट, प्रत्येक
sk-ने सुरू होणाऱ्या API कीने कॉल केला जातो. प्रमाणीकरण