ወደ ይዘቱ እለፍ
ችሎታዎች

ችሎታዎች

እያንዳንዱ ሞዴል በAPI በኩል ምን ማድረግ እንደሚችል፣ ሞዴል በሞዴል፦ tools፣ የምስል input፣ reasoning፣ የJSON ውጤት፣ prompt caching፣ ድር ፍለጋ እና streaming።

እያንዳንዱ ሞዴል በተመሳሳይ ቁልፍ በተመሳሳይ ሦስት endpoints ይደረስበታል። ሁለቱ ሠንጠረዦች ሞዴሎቹ የሚለያዩበትን ያሳያሉ። ሰረዝ ማለት ሞዴሉ ያለዚያ ችሎታ ይመልሳል ማለት ነው።

የShannon ሞዴሎች

ሞዴል ToolsምስሎችReasoningEffortJSON ነገርJSON schemaCachingፍለጋStreaming
shannon-1.6-lite አዎአዎ——አዎአዎ—አዎአዎ
shannon-1.6-pro አዎአዎአዎ—አዎአዎ—አዎአዎ
shannon-2-lite አዎ—አዎ—አዎአዎ—አዎአዎ
shannon-2-pro አዎ—አዎ—አዎአዎ—አዎአዎ
shannon-3 አዎአዎአዎ—አዎአዎ—አዎአዎ
shannon-3-pro አዎአዎአዎ—አዎአዎ—አዎአዎ
shannon-3.1 አዎአዎአዎ—አዎአዎ—አዎአዎ
shannon-3.1-pro አዎአዎአዎ—አዎአዎ—አዎአዎ
shannon-3.5 አዎ———አዎአዎ——አዎ
shannon-coder-1 አዎ—አዎ—አዎአዎ——አዎ

የሆስት open-weight ሞዴሎች

የሆስት ሞዴል id ስሙና ልዩነቱ በሰረዝ ተያይዘው ነው፣ ለምሳሌ DeepSeek-V4-Pro-0813-3BIT-REAP።

ሞዴል ToolsምስሎችReasoningEffortJSON ነገርJSON schemaCachingፍለጋStreaming
DeepSeek-V4-Pro-0813 3BIT-REAP አዎ—አዎአዎአዎአዎአዎ—አዎ
GLM-5.2 3BIT-REAP አዎ—አዎአዎአዎአዎአዎ—አዎ
Kimi-K3 3BIT-REAP አዎአዎአዎአዎአዎአዎአዎ—አዎ
Nemotron3Ultra 3BIT-REAP አዎ—አዎአዎአዎአዎአዎ—አዎ
MiniMax-M3 3BIT-REAP አዎአዎአዎአዎአዎአዎአዎ—አዎ
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP አዎ—አዎአዎአዎአዎአዎ—አዎ
Kimi-K2.6 W4A16-AUTOROUND-REAP አዎአዎአዎአዎአዎአዎአዎ—አዎ
Laguna-S-2.1 W4A16-AUTOROUND-REAP አዎ—አዎአዎ——አዎ—አዎ
inkling W4A16-AUTOROUND-REAP አዎአዎአዎአዎአዎ—አዎ—አዎ
MiMo-V2.5-Pro W8A16 አዎ—አዎአዎአዎአዎአዎ—አዎ
MiMo-V2.5 W8A16 አዎአዎአዎአዎአዎአዎአዎ—አዎ
Hy3 W8A16 አዎ—አዎአዎአዎአዎአዎ—አዎ

እያንዳንዱ ዓምድ ምን ማለት ነው

  • Tools. ፋንክሽኖችን በtools ይገልጻሉ፣ ሞዴሉ እንዲደረጉ የሚፈልጋቸውን ጥሪዎች ይመልሳል፣ እና ኮድዎ ያስኬዳቸዋል። እያንዳንዱ ሞዴል tools ይቀበላል። የተገደደ tool_choice በሆስት open-weight ሞዴሎች ይተገበራል። ፋንክሽን ጥራት
  • የምስል input. ሞዴሉ በተጠቃሚ መልእክት ውስጥ የተላኩ ምስሎችን እንደ data URL ወይም እንደ አድራሻ ያነባል። shannon-2-lite እና shannon-2-pro tools ወይም response_format በሚልኩ ጥያቄዎች ውስጥም ምስሎችን ያነባሉ። የShannon 3 ቤተሰብ ሰነዶችንም ያነባል። ምስሎች እና ፋይሎች
  • Reasoning. ምላሹ የሞዴሉን የreasoning ጽሑፍ ከመልሱ ጎን በራሱ መስክ ሊይዝ ይችላል። Reasoning effort
  • Reasoning effort. የጥያቄ መስክ ሞዴሉ ምን ያህል ጥልቀት እንደሚያስብ ያዘጋጃል፦ off, low, medium ወይም high። የShannon ሞዴሎች የራሳቸውን ጥልቀት ያዘጋጃሉ። Reasoning effort
  • JSON ነገር. በresponse_format: {"type": "json_object"} መልሱ የተወሰነ ቅርጽ የሌለው JSON ነው። በ/v1/chat/completions እና በ/v1/responses ላይ። የተዋቀሩ ውጤቶች
  • JSON schema. ዓይነቱ json_schema የሆነ response_format ሲጠቀሙ መልሱ የላኩትን schema ይከተላል። በ/v1/chat/completions እና በ/v1/responses ላይ። የተዋቀሩ ውጤቶች
  • Prompt caching. በተመሳሳይ ሞዴል ላይ እንደ ቅርብ prompt የሚጀምር prompt ከcache ይነበባል፣ እና cached ክፍሉ በinput ዋጋ 25% ይሰላል። የጥያቄ መስክ አያስፈልገውም። የፕሮምፕት ካሽንግ
  • ድር ፍለጋ. በweb_search: true API ድሩን ይፈልጋል እና ሞዴሉ ከመመለሱ በፊት ውጤቶቹን ይሰጠዋል። በ/v1/chat/completions እና በ/v1/messages ላይ። የጥያቄው መስክ ነው እና በGET /v1/models ውስጥ flag የለውም። የተገናኘ ድር ፍለጋ
  • Streaming. በstream: true ሞዴሉ በሚጽፍበት ጊዜ ምላሹ እንደ server-sent events ይደርሳል። እያንዳንዱ ሞዴል በሦስቱም endpoints ላይ stream ያደርጋል። ስትሪሚንግ

ተመሳሳይ እውነታዎች ከGET /v1/models

GET https://api.shannon-ai.com/v1/models

GET /v1/models እያንዳንዱን ሞዴል በcapabilities ነገር ይዘረዝራል፣ ስለዚህ ፕሮግራም ከዚህ ገጽ ይልቅ እነዚህን እውነታዎች ማንበብ ይችላል። Endpointው ቁልፍ አይፈልግም።

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

የdata ሁለት ግቤቶች id እና capabilities፦

200 JSON
[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]
ዓምድ በcapabilities ውስጥ ያለ flag
Tools tools
የምስል input vision
Reasoning reasoning
Reasoning effort reasoning_effort
JSON ነገር response_format
JSON schema json_schema
Prompt caching prompt_caching
ድር ፍለጋ flag አይደለም፦ የጥያቄ መስክ web_search።
Streaming streaming
  • response_format እና prompt_caching የሆስት open-weight ግቤቶች flags ናቸው። የShannon ግቤት የJSON ውጤትን በjson_schema ብቻ ያሳውቃል፣ ይህም ለሁለቱም JSON ሁነታዎች ይቆማል።
  • vision ለshannon-2-lite እና shannon-2-pro true ነው፦ tools ወይም response_format በሚልኩ ጥያቄዎች ውስጥም ምስሎችን ያነባሉ።

ከሞዴል ረድፍ ውጭ

የሆስት open-weight ሞዴል ከረድፉ ውጭ የሆነ ምስል ወይም JSON ሁነታ ይከለክላል። ክልከላው ከቀሪ ሂሳብዎ ምንም ከመቀነሱ በፊት ይመጣል፦

ሁኔታ ዓይነት መልእክት መቼ
400 invalid_request_error <id> does not accept image input ምስል የምስል input ለሌለው የሆስት open-weight ሞዴል ተልኳል።
400 invalid_request_error <id> does not accept response_format JSON ውጤት ሁለቱም JSON ሁነታዎች ለሌሉት የሆስት open-weight ሞዴል ተጠይቋል።
400 invalid_request_error <id> does not accept response_format json_schema; use json_object schema የJSON ነገር ሁነታ ብቻ ላለው የሆስት open-weight ሞዴል ተልኳል።

የShannon ሞዴል እንዲህ ያለውን ጥያቄ በሁኔታ 200 ይመልሳል፦ ከረድፉ ውጭ ያለው ችሎታ በመልሱ ውስጥ ድርሻ አይኖረውም። ስህተት አስተዳደር