ችሎታዎች
እያንዳንዱ ሞዴል በAPI በኩል ምን ማድረግ እንደሚችል፣ ሞዴል በሞዴል፦ tools፣ የምስል input፣ reasoning፣ የJSON ውጤት፣ prompt caching፣ ድር ፍለጋ እና streaming።
እያንዳንዱ ሞዴል በተመሳሳይ ቁልፍ በተመሳሳይ ሦስት endpoints ይደረስበታል። ሁለቱ ሠንጠረዦች ሞዴሎቹ የሚለያዩበትን ያሳያሉ። ሰረዝ ማለት ሞዴሉ ያለዚያ ችሎታ ይመልሳል ማለት ነው።
የShannon ሞዴሎች
| ሞዴል | Tools | ምስሎች | Reasoning | Effort | JSON ነገር | JSON schema | Caching | ፍለጋ | 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 | ምስሎች | Reasoning | Effort | JSON ነገር | JSON schema | Caching | ፍለጋ | 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-protoolsወይም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: trueAPI ድሩን ይፈልጋል እና ሞዴሉ ከመመለሱ በፊት ውጤቶቹን ይሰጠዋል። በ/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)) import OpenAI from "openai";
const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });
for await (const model of client.models.list()) {
console.log(model.id, model.capabilities);
} curl https://api.shannon-ai.com/v1/models የ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-protrueነው፦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 ይመልሳል፦ ከረድፉ ውጭ ያለው ችሎታ በመልሱ ውስጥ ድርሻ አይኖረውም። ስህተት አስተዳደር