የለውጦች መዝገብ
Shannon API የቅርብ ጊዜ ዝመናዎችና ማሻሻያዎች።
ይህ ገጽ እንደ API ጠሪ ሊመለከቷቸው የሚችሉ ለውጦችን ይዘረዝራል፦ አዲስ endpoints፣ መስኮች እና ሞዴሎች፣ የተለወጡ ባህሪዎች እና ጥገናዎች። አዲሶቹ ግቤቶች መጀመሪያ ይመጣሉ። እያንዳንዱ ግቤት ለውጡ የተደረገበትን ቀን ይይዛል።
Breaking ተብሎ የተመለከተ ግቤት ቀደም ሲል ይሰራ የነበረን ጥያቄ ውጤት ሊለውጥ ይችላል። APIው አንድ ስሪት፣ /v1፣ አለው፣ ስለዚህ ለውጦች በቀን ተዘርዝረዋል እንጂ በስሪት ቁጥር አይደለም።
- አዲስ
web_search: trueያለው ጥያቄ ምንጮቹን ይሰይማል፦ በ/v1/chat/completionsእና በ/v1/messagesላይsourcesለሞዴሉ የተሰጡትን ውጤቶች ይዘረዝራል፣ በ/v1/chat/completionsላይ ደግሞannotationsመልሱ እያንዳንዱን የጠቀሰበትን ቦታ ያመለክታል። የተገናኘ ድር ፍለጋ
- አዲስ
web_search: trueበ/v1/chat/completionsእና በ/v1/messagesላይ ሞዴሉ ከመመለሱ በፊት የድር ፍለጋ ያካሂዳል እና ውጤቱን እንደ ቁጥር የተሰጣቸው ምንጮች ይሰጠዋል። ውጤት ያገኘ ጥያቄ ከዕለታዊ አበልዎ አንድ ፍለጋ ይጠቀማል። ምንም ካልቀረ ጥያቄው ያለ ፍለጋ ይመለሳል። የተገናኘ ድር ፍለጋ
- ተጠጋገመ
በሰርቨር በኩል የተቋረጠ stream እስከዚያ ነጥብ በተገለጸው usage ይሰላል። የድርሻው ቀሪ ወደ ቀሪ ሂሳብዎ ይመለሳል።
- ተጠጋገመ
shannon-coder-1በሌሎቹ ሁለት endpoints ላይ እንደሚያደርገው በ/v1/responsesላይ ይመልሳል። የCLI ኮዲንግ መሣሪያዎች - ተጠጋገመ
የተቀየረ API ቁልፍ ወዲያውኑ መስራት ያቆማል።
- አዲስ
POST /v1/tokenizeእናPOST /v1/messages/count_tokens፦ ለሆስት open-weight ሞዴሎች ነጻ የtoken ቆጠራዎች። የToken ቆጠራ - አዲስ
በሆስት open-weight ሞዴሎች ላይ Prompt caching። Cached input በinput ዋጋ 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ያሳውቃል። የፕሮምፕት ካሽንግ - ተጠጋገመ
የሆስት open-weight ሞዴሎች፦ የተገደደ
tool_choice(requiredወይም የተሰየመ ፋንክሽን) የtool ጥሪ ያስገኛል። ፋንክሽን ጥራት - ተጠጋገመ
የሆስት open-weight ሞዴሎች የውይይቱ የመጀመሪያ መልእክት ያልሆነ
systemመልእክት ይቀበላሉ።
- አዲስ
APIው እንደ Tor onion service እና በI2P አድራሻ ሊደረስበት ይችላል። የ
api.shannon-ai.comምላሾች ሁለቱን አድራሻዎች በOnion-Locationእና በX-I2P-Locationheaders ይይዛሉ። የተመሰጠሩ፣ Tor & I2P endpoints
- አዲስ
አዲስ ሞዴሎች
shannon-3.1እናshannon-3.1-pro፣ በGET /v1/modelsየተዘረዘሩ። ሞዴሎችና ዋጋ - ተለውጧል
ክላይንቱ የሚያቋርጥበት stream ጥያቄ እስከ መጨረሻው ይሰራል እና ይቆጠራል። ከዚህ በፊት መልሱ በመቋረጡ ላይ ይቆም ነበር።
- ተጠጋገመ
ወደ
/v1/responsesየሚደረጉ ጥያቄዎች በusage ምዝግብ ውስጥ ይታያሉ።
- አዲስ
የሆስት open-weight ሞዴሎች የsampling መስኮችን ይተገብራሉ፦ በ
/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እሴት በሦስቱም endpoints ላይ በ400፣ በዓይነትinvalid_request_errorእና በመልእክትunknown model: <id>ይመለሳል። ከዚህ በፊት እንዲህ ያለ ጥያቄ በshannon-1.6-liteይመለስ ነበር። ሞዴሎችና ዋጋ - ሰብር
/v1የሚቀበለው API ቁልፍ ብቻ ነው። የድር ጣቢያው የመግቢያ ኩኪ እዚያ አይነበብም። ማረጋገጫ - ተለውጧል
Flood protection፦ በሦስቱ የማመንጫ endpoints ላይ በመለያ በደቂቃ 120 ጥያቄዎች። ገደቦች እና ቀሪ ሂሳብ
- ተሻሻለ
ሞዴሉ መመለስ ሲያቅተው ስህተቱ ቋሚውን መልእክት
The model backend failed to answer. Please retry.ይይዛል። ሊደረግ የማይችል የቀሪ ሂሳብ ፍተሻ በ503እና በዓይነትapi_errorይመለሳል። ስህተት አስተዳደር - ተጠጋገመ
የወደቀ stream ያልሆነ ጥያቄ የያዘውን ድርሻ ወደ ቀሪ ሂሳብዎ ይመልሳል።
- አዲስ
GET /v1/modelsለእያንዳንዱ ሞዴልcapabilities.reasoning_effortያሳውቃል። Reasoning effort - ተሻሻለ
የሆስት open-weight ሞዴሎች፦ መልስ የማያገኝ stream ያልሆነ ጥያቄ በ
504እና በዓይነትapi_errorያበቃል። ባዶ ውጤት502ነው። ስህተት አስተዳደር
- ሰብር
የሆስት open-weight ሞዴሎች የተሰየመው ሞዴል የሚቀበለውን input ይቀበላሉ። ጽሑፍ-ብቻ id የተላከ ምስል በ
400እና በ<id> does not accept image inputይመለሳል። የተዋቀረ ውጤት በሌለው id ላይresponse_formatበ400ይመለሳል።GET /v1/modelsለእያንዳንዱ idcapabilities.vision,response_formatእናjson_schemaያሳውቃል። ምስሎች እና ፋይሎች - ተጠጋገመ
stream ያልሆኑ ምላሾች የreasoning ጽሑፍ ይይዛሉ፦ በ
/v1/chat/completionsመልእክት ላይreasoning_content፣ እና በ/v1/messagesላይ ከጽሑፉ በፊትthinkingblock። Reasoning effort - ተለውጧል
የሆስት open-weight ሞዴሎች አዲስ ዋጋ አላቸው፣ ከ$0.50 በ1M input tokens እና ከ$2.00 በ1M output tokens። ሞዴሎችና ዋጋ
- ተለውጧል
የሆስት open-weight ሞዴሎች በአንድ ሞዴል አንድ id አላቸው፣ በጠቅላላው አስራ ሁለት ids። ሞዴሎችና ዋጋ
- አዲስ
በ
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/responsesየShannon ሞዴሎችን reasoning ይመልሳል፦ ከmessageንጥል በፊትreasoningየውጤት ንጥል፣ እና የstream eventsresponse.reasoning_summary_text.deltaእናresponse.reasoning_summary_text.done። Responses API - ተጠጋገመ
የምላሽ
modelመስክ በእያንዳንዱ endpoint ላይ የታተመው id ነው። የResponses ነገርmodelእናcreated_atይይዛል። - ተሻሻለ
GET /v1/modelsየእያንዳንዱን ሞዴል የcontext መስኮት ያሳውቃል። ሞዴሎችና ዋጋ
- አዲስ
የሆስት open-weight ሞዴሎች ከ
/v1/chat/completionsበተጨማሪ በ/v1/messagesእና በ/v1/responsesላይ ከsystem prompt እና ከtool ጥሪዎች ጋር ይመልሳሉ።/v1/messagesthinkingይቀበላል፣ እናreasoning_effortየጥያቄ መስክ ነው። ሞዴሎችና ዋጋ - ተሻሻለ
በ
/v1ላይ ያሉ የስህተት አካላት የSDK ቅርጾችን ይከተላሉ፦ በOpenAI-ቅርጸት endpoints ላይtypeእናmessageያለውerrorነገር፣ በ/v1/messagesላይ ደግሞ ተመሳሳይ ነገር በ{"type": "error"}ውስጥ። ስህተት አስተዳደር - አዲስ
በክፍት streams ላይ በየ15 ሰከንዱ Keep-alive፦ በ
/v1/chat/completionsላይ: pingየአስተያየት መስመር፣ በ/v1/messagesላይevent: ping። ስትሪሚንግ - ተለውጧል
የtool ጥሪ ids በ
/v1/chat/completionsእና በ/v1/responsesላይ በcall_ይጀምራሉ፣ በ/v1/messagesላይ ደግሞ በtoolu_። ፋንክሽን ጥራት - ሰብር
/v1/responses፦streamነባሪውfalseነው። Responses API - አዲስ
max_completion_tokensበ/v1/chat/completionsላይ ለ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 ሊሆኑ ይችላሉ። - አዲስ
ቁልፍ አዲስ ሳይሰጥ ሊሰረዝ ይችላል። የusage ምዝግብ በገጽ የተከፋፈለ ነው።
- አዲስ
በጥያቄዎች ውስጥ ምስሎችና ሰነዶች፦ በ
/v1/chat/completionsላይimage_urlክፍሎች፣ በ/v1/messagesላይimage,documentእናfileblocks፣ በ/v1/responsesላይinput_imageክፍሎች። ምስሎች እና ፋይሎች - አዲስ
አዲስ ሞዴል
shannon-3-pro። ሞዴሎችና ዋጋ
- አዲስ
አዲስ ሞዴል
shannon-3። ሞዴሎችና ዋጋ - አዲስ
በ
/v1/chat/completionsላይ ያሉ streams reasoningን እንደdelta.reasoning_contentይይዛሉ። Reasoning effort
- ተለውጧል
max_tokensበ1 እና 65,536 መካከል ይቆያል። ከዚያ ክልል ውጭ ያለ እሴት ወደ ቅርቡ ጫፍ ይወሰዳል እንጂ አይከለከልም። Chat Completions
- አዲስ
shannon-coder-1በ/v1/chat/completionsእና በ/v1/messagesላይ በፕላን በጥሪዎች ይቆጠራል። የመስኮት ጥሪዎች ሲያልቁ ምላሹShannon Coder call quota reachedበሚል መልእክት429ነው። የCLI ኮዲንግ መሣሪያዎች - አዲስ
ከcontext መስኮቱ የሚበልጥ ውይይት በ
400፣ በዓይነትinvalid_request_errorእና በኮድcontext_length_exceededይመለሳል። በstream ውስጥ ያለ ስህተት እንደ error event ይደርሳል እንጂ በመልሱ ውስጥ እንደ ጽሑፍ አይደለም። የCLI ኮዲንግ መሣሪያዎች
- አዲስ
የ
/v1endpoints፦POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesእናGET /v1/models። የOpenAI እና የAnthropic SDKs፣ Claude Code እና Codex CLI የሚጠሯቸው endpoints ናቸው። አጠቃላይ እይታ - አዲስ
በ
/v1/chat/completionsእና በ/v1/messagesላይ በtoolsየtool ጥሪዎች፣ በresponse_formatየተዋቀረ ውጤት፣ እና በ/v1/messagesላይsystemእንደ string ወይም እንደ የጽሑፍ blocks። ፋንክሽን ጥራት
- አዲስ
ከ
shannon-1.6-liteጎን የሞዴል idsshannon-1.6-pro,shannon-2-lite,shannon-2-proእናshannon-coder-1። ሞዴሎችና ዋጋ
- አዲስ
የAPIው የመጀመሪያ መለቀቅ፦ በOpenAI ቅርጸት እና በAnthropic ቅርጸት ቻት፣ እና Responses endpoint፣ እያንዳንዳቸው በ
sk-በሚጀምር API ቁልፍ የሚጠሩ። ማረጋገጫ