ናብ ትሕዝቶ ዝለል
የለውጥ መዝገብ

የለውጥ መዝገብ

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 ክልቲኡ ኣድራሻታት ኣብ headers Onion-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 ይምለስ ነበረ። ሞዴላትን ዋጋን

  • ዝልውጥ

    /v1 API ቁልፊ ጥራይ ይቕበል። ናይ 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 ንነፍሲ ወከፍ id capabilities.vision፣ response_format ከምኡውን json_schema ይሕብር። ስእልታትን ፋይላትን

  • ተስሪ

    Non-streamed ምላሻት ጽሑፍ reasoning ይሓዙ፦ reasoning_content ኣብ መልእኽቲ ናይ /v1/chat/completions፣ ከምኡውን thinking block ቅድሚ ጽሑፍ ኣብ /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/responses reasoning ናይ Shannon ሞዴላት ይመልስ፦ reasoning output item ቅድሚ message item፣ ከምኡውን stream events response.reasoning_summary_text.delta ከምኡውን response.reasoning_summary_text.done። Responses API

  • ተስሪ

    እቲ model field ናይ ምላሽ ኣብ ነፍሲ ወከፍ endpoint እቲ ዝታወጀ id እዩ። Responses object model ከምኡውን created_at ይሓዝ።

  • ተሻሽለ

    GET /v1/models context window ናይ ነፍሲ ወከፍ ሞዴል የርእይ። ሞዴላትን ዋጋን

  • ሓድሽ

    ዝተሃንደሱ open-weight ሞዴላት ኣብ /v1/messages ከምኡውን /v1/responses ከምኡ እውን ኣብ /v1/chat/completions ይመልሱ፣ ምስ system prompt ከምኡውን tool ጥሪታት ናትካ። /v1/messages thinking ይቕበል፣ reasoning_effort ድማ ናይ ጠለብ field እዩ። ሞዴላትን ዋጋን

  • ተሻሽለ

    ናይ ጌጋ bodies ኣብ /v1 ቅርጺ SDK ይስዕቡ፦ ኣብ endpoints ናይ ቅርጺ OpenAI error object ምስ 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.completed event እቲ output array ይሓዝ። Responses API

  • ሓድሽ

    Entries ናይ GET /v1/models display_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 ከምኡውን file blocks ኣብ /v1/messages፣ input_image ክፍልታት ኣብ /v1/responses። ስእልታትን ፋይላትን

  • ሓድሽ

    ሓዲሽ ሞዴል shannon-3-pro። ሞዴላትን ዋጋን

  • ዝተቐየረ

    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 ከምኡውን code context_length_exceeded ይምለስ። ኣብ ውሽጢ stream ዘሎ ጌጋ ከም error event እምበር ከም ጽሑፍ ኣብ መልሲ ኣይመጽእን። CLI ናይ ኮዲንግ መሳለጥያታት

  • ሓድሽ

    እቶም /v1 endpoints፦ 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 ቁልፊ ዝጽዋዕ። ማረጋገጫ