የለውጥ መዝገብ
Shannon API ዝመጹ ዝርዝር ምሓደስ እና ምሻል።
እዚ ገጽ ከም ጸዋዒ ናይ API ዘተዓዘብካዮም ለውጥታት ይዝርዝር፦ ሓደሽቲ endpoints፣ fields ከምኡውን ሞዴላት፣ ዝተቐየረ ኣካይዳ ከምኡውን ዝተሰርሑ ጌጋታት። እቶም ሓደስቲ entries ቀዳምቲ እዮም። ነፍሲ ወከፍ entry እቲ ለውጢ ዝተገብረሉ ዕለት ይሓዝ።
ብ ዝልውጥ ዝተመልከተ entry ቅድሚ ዝሰርሐ ጠለብ ውጽኢት ክቕይር ይኽእል። እቲ API ሓደ ዕትም ኣለዎ፣ /v1፣ ስለዚ ለውጥታት ብዕለት እምበር ብቁጽሪ ዕትም ይዝረዘሩ።
- ሓድሽ
ጠለብ
web_search: trueዘለዎ ምንጭታቱ ይሰምዮም፦sourcesኣብ/v1/chat/completionsከምኡውን/v1/messagesነቶም ንሞዴል ዝተዋህቡ ውጽኢታት ይዘርዝር፣ ኣብ/v1/chat/completionsድማannotationsእቲ መልሲ ንነፍሲ ወከፍ ኣበይ ከም ዝጠቅሶ የመልክት። የድር ፍለጋ
- ሓድሽ
web_search: trueኣብ/v1/chat/completionsከምኡውን/v1/messagesቅድሚ እቲ ሞዴል ምምላሱ web ድሌት የሰርሕ እሞ ውጽኢታት ከም ዝተቐጸሩ ምንጭታት ይህቦ። ውጽኢት ዝረኸበ ጠለብ ሓንቲ ድሌት ካብ ዕለታዊ allowance ናትካ ይጥቀም። ዝተረፈ እንተ ዘየለ፣ እቲ ጠለብ ብዘይ ድሌት ይምለስ። የድር ፍለጋ
- ተስሪ
ኣብ ወገን server ዝተቖረጸ stream ክሳብ ሽዑ ብዝተሓበረ usage ይኽፈል። እቲ ዝተረፈ ዝተዓቆበ ናብ ሚዛንካ ይምለስ።
- ተስሪ
shannon-coder-1ኣብ/v1/responsesከምቲ ኣብ ክልተ ካልኦት endpoints ይመልስ። CLI ናይ ኮዲንግ መሳለጥያታት - ተስሪ
ዝተቐየረ API ቁልፊ ብቕጽበት ምስራሕ የቋርጽ።
- ሓድሽ
POST /v1/tokenizeከምኡውንPOST /v1/messages/count_tokens፦ ንዝተሃንደሱ open-weight ሞዴላት ነጻ ቆጸራ token። ምቑጻር Token - ሓድሽ
Prompt caching ኣብ ዝተሃንደሱ open-weight ሞዴላት። Cached ኣተዋዕዎ ብ25% ናይ ዋጋ ኣተዋዕዎ ይኽፈል ከምኡውን ኣብ
usageኣብ ኩሎም ሰለስተ endpoints ይሕበር፦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ይሕብር። Prompt caching - ተስሪ
ዝተሃንደሱ open-weight ሞዴላት፦ ዝተገደደ
tool_choice(requiredወይ ዝተሰምየ function) tool ጥሪ የምጽእ። ግብር ጥሪ - ተስሪ
ዝተሃንደሱ open-weight ሞዴላት ቀዳማይ መልእኽቲ ናይ ዘተ ዘይኮነ
systemመልእኽቲ ይቕበሉ።
- ሓድሽ
እቲ API ከም Tor onion service ከምኡውን ኣብ I2P ኣድራሻ ይርከብ። ምላሻት
api.shannon-ai.comክልቲኡ ኣድራሻታት ኣብ headersOnion-LocationከምኡውንX-I2P-Locationይሓዙ። Encrypted, Tor & I2P endpoints
- ሓድሽ
ሓደሽቲ ሞዴላት
shannon-3.1ከምኡውንshannon-3.1-pro፣ ብGET /v1/modelsዝተዘርዘሩ። ሞዴላትን ዋጋን - ዝተቐየረ
ክላይንቱ ዝተቋረጸ streamed ጠለብ ክሳብ መወዳእታኡ ይሰርሕ ከምኡውን ይቝጸር። ቅድሚ እዚ መልሲ ኣብ ምቁራጽ ይቋረጽ ነበረ።
- ተስሪ
ጠለባት ናብ
/v1/responsesኣብ usage log ይርኣዩ።
- ሓድሽ
ዝተሃንደሱ open-weight ሞዴላት sampling fields ይትግብሩ፦
temperature፣top_p፣seed፣stopከምኡውንmax_tokensኣብ/v1/chat/completions፤temperature፣top_pከምኡውንstop_sequencesኣብ/v1/messages፤temperature፣top_pከምኡውንmax_output_tokensኣብ/v1/responses። Chat Completions - ሓድሽ
እቲ usage log ንነፍሲ ወከፍ ጥሪ ከምኡውን ከም ድምር ዋጋ ብ USD የርኢ።
- ዝልውጥ
ዝታወጀ id ዘይኮነ
modelዋጋ ኣብ ሰለስተ endpoints ብ400፣ ዓይነትinvalid_request_errorከምኡውን መልእኽቲunknown model: <id>ይምለስ። ቅድሚ እዚ ከምዚ ዝበለ ጠለብ ብshannon-1.6-liteይምለስ ነበረ። ሞዴላትን ዋጋን - ዝልውጥ
/v1API ቁልፊ ጥራይ ይቕበል። ናይ web ሳይት ናይ ምእታው ኩኪ ኣብኡ ኣይነበበን። ማረጋገጫ - ዝተቐየረ
Flood protection፦ 120 ጠለባት ኣብ ደቒቕ ንነፍሲ ወከፍ ኣካውንት ኣብ ሰለስተ generation endpoints። ገደባትን ሚዛንን
- ተሻሽለ
እቲ ሞዴል ክምልስ ምስ ዘይክእል፣ እቲ ጌጋ እዚ ዘይቅየር መልእኽቲ ይሓዝ
The model backend failed to answer. Please retry.ክግበር ዘይክእል ምርግጋጽ ሚዛን ብ503ከምኡውን ዓይነትapi_errorይምለስ። ሓጋይ ኣስተዳደር - ተስሪ
ዝወደቐ non-streamed ጠለብ ዝተዓቆበ ንሚዛንካ ይመልስ።
- ሓድሽ
GET /v1/modelsንነፍሲ ወከፍ ሞዴልcapabilities.reasoning_effortይሕብር። Reasoning effort - ተሻሽለ
ዝተሃንደሱ open-weight ሞዴላት፦ መልሲ ዘይረኸበ non-streamed ጠለብ ብ
504ከምኡውን ዓይነትapi_errorይውዳእ። ባዶ ውጽኢት502እዩ። ሓጋይ ኣስተዳደር
- ዝልውጥ
ዝተሃንደሱ open-weight ሞዴላት እቲ ዝተሰምየ ሞዴል ዝቕበሎ ኣተዋዕዎ ይቕበሉ። ስእሊ ናብ ጽሑፍ-ጥራይ id ዝተላእከ ብ
400ከምኡውን<id> does not accept image inputይምለስ።response_formatኣብ id ዘይብሉ ዝተዋቀረ ውጽኢት ብ400ይምለስ።GET /v1/modelsንነፍሲ ወከፍ idcapabilities.vision፣response_formatከምኡውንjson_schemaይሕብር። ስእልታትን ፋይላትን - ተስሪ
Non-streamed ምላሻት ጽሑፍ reasoning ይሓዙ፦
reasoning_contentኣብ መልእኽቲ ናይ/v1/chat/completions፣ ከምኡውንthinkingblock ቅድሚ ጽሑፍ ኣብ/v1/messages። Reasoning effort - ዝተቐየረ
ዝተሃንደሱ open-weight ሞዴላት ሓደሽቲ ዋጋታት ኣለዎም፣ ካብ $0.50 ንነፍሲ ወከፍ 1M ኣተዋዕዎ tokens ከምኡውን $2.00 ንነፍሲ ወከፍ 1M ውጽኢት 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/responsesreasoning ናይ Shannon ሞዴላት ይመልስ፦reasoningoutput item ቅድሚmessageitem፣ ከምኡውን stream eventsresponse.reasoning_summary_text.deltaከምኡውንresponse.reasoning_summary_text.done። Responses API - ተስሪ
እቲ
modelfield ናይ ምላሽ ኣብ ነፍሲ ወከፍ endpoint እቲ ዝታወጀ id እዩ። Responses objectmodelከምኡውንcreated_atይሓዝ። - ተሻሽለ
GET /v1/modelscontext window ናይ ነፍሲ ወከፍ ሞዴል የርእይ። ሞዴላትን ዋጋን
- ሓድሽ
ዝተሃንደሱ open-weight ሞዴላት ኣብ
/v1/messagesከምኡውን/v1/responsesከምኡ እውን ኣብ/v1/chat/completionsይመልሱ፣ ምስ system prompt ከምኡውን tool ጥሪታት ናትካ።/v1/messagesthinkingይቕበል፣reasoning_effortድማ ናይ ጠለብ field እዩ። ሞዴላትን ዋጋን - ተሻሽለ
ናይ ጌጋ bodies ኣብ
/v1ቅርጺ SDK ይስዕቡ፦ ኣብ endpoints ናይ ቅርጺ OpenAIerrorobject ምስtypeከምኡውንmessage፣ ኣብ/v1/messagesድማ እቲ ተመሳሳሊ object ኣብ ውሽጢ{"type": "error"}። ሓጋይ ኣስተዳደር - ሓድሽ
Keep-alive ኣብ ክፉት streams ኣብ ነፍሲ ወከፍ 15 ሰከንድ፦ መስመር ርእይቶ
: pingኣብ/v1/chat/completions፣event: pingድማ ኣብ/v1/messages። ስትሪም - ዝተቐየረ
Ids ናይ tool ጥሪ ኣብ
/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 stream ዝኾነ
response.completedevent እቲoutputarray ይሓዝ። Responses API - ሓድሽ
Entries ናይ
GET /v1/modelsdisplay_name፣context_window፣max_output_tokens፣pricing፣capabilitiesከምኡውንendpointsይሓዙ። ሞዴላትን ዋጋን - ሓድሽ
ነፍሲ ወከፍ ምላሽ
x-request-idይሓዝ፣ ዝለኣኽካዮ ዋጋ ድማ ይምለስ። Request bodies ክሳብ 32 MiB ክኾኑ ይኽእሉ። - ሓድሽ
ቁልፊ ብዘይ ሓዲሽ ምሃብ ክስረዝ ይኽእል። እቲ usage log ብገጻት ይቐርብ።
- ሓድሽ
ስእልታትን ሰነዳትን ኣብ ጠለባት፦
image_urlክፍልታት ኣብ/v1/chat/completions፣image፣documentከምኡውንfileblocks ኣብ/v1/messages፣input_imageክፍልታት ኣብ/v1/responses። ስእልታትን ፋይላትን - ሓድሽ
ሓዲሽ ሞዴል
shannon-3-pro። ሞዴላትን ዋጋን
- ሓድሽ
ሓዲሽ ሞዴል
shannon-3። ሞዴላትን ዋጋን - ሓድሽ
Streams ኣብ
/v1/chat/completionsreasoning ከምdelta.reasoning_contentይሓዙ። Reasoning effort
- ዝተቐየረ
max_tokensኣብ 1 ክሳብ 65,536 ይሕሎ። ካብዚ ወሰን ወጻኢ ዝኾነ ዋጋ ናብ ቀረባ ዳር ይቐርብ እምበር ኣይተነጸገን። Chat Completions
- ሓድሽ
shannon-coder-1ኣብ/v1/chat/completionsከምኡውን/v1/messagesብጥሪታት ንነፍሲ ወከፍ ፕላን ይቝጸር። ጥሪታት ናይ ሓደ መስኮት ምስ ዝውዳእ፣ እቲ ምላሽ429ምስ መልእኽቲShannon Coder call quota reachedእዩ። CLI ናይ ኮዲንግ መሳለጥያታት - ሓድሽ
ካብ context window ዝዓቢ ዘተ ብ
400፣ ዓይነትinvalid_request_errorከምኡውን codecontext_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 እዮም። መግለጺ - ሓድሽ
Tool ጥሪታት ብ
toolsኣብ/v1/chat/completionsከምኡውን/v1/messages፣ ዝተዋቀረ ውጽኢት ብresponse_format፣ ከምኡውንsystemከም string ወይ ከም text blocks ኣብ/v1/messages። ግብር ጥሪ
- ሓድሽ
ሞዴል ids
shannon-1.6-pro፣shannon-2-lite፣shannon-2-proከምኡውንshannon-coder-1፣ ኣብ ጥቓshannon-1.6-lite። ሞዴላትን ዋጋን
- ሓድሽ
ቀዳማይ ዕትም ናይ API፦ chat ብቅርጺ OpenAI ከምኡውን ብቅርጺ Anthropic፣ ከምኡውን Responses endpoint፣ ነፍሲ ወከፍ ብ
sk-ዝጅምር API ቁልፊ ዝጽዋዕ። ማረጋገጫ