ክእለታት

ነፍሲ ወከፍ ሞዴል ብተመሳሳሊ ሰለስተ endpoints ብተመሳሳሊ ቁልፊ ይበጻሕ። እቶም ክልተ ሰንጠረዛት ሞዴላት ኣበይ ከም ዝፈላለዩ የርእዩ። ሓደ ሰረዝ እቲ ሞዴል ብዘይ እቲ ክእለት ይመልስ ማለት እዩ።

Shannon ሞዴላት

ዝተሃንደሱ open-weight ሞዴላት

ናይ ዝተሃንደሰ ሞዴል id ስሙን ዓይነቱን ብ hyphen ዝተጸንበሩ እዩ፣ ንኣብነት DeepSeek-V4-Pro-0813-3BIT-REAP።

እንታይ ማለት እዩ ነፍሲ ወከፍ ዓምዲ

• Tools. Functions ኣብ tools ትገልጽ፣ እቲ ሞዴል ክግበሩ ዝደሊ ጥሪታት ይመልስ፣ ኮድካ ድማ የስርሖም። ነፍሲ ወከፍ ሞዴል tools ይቕበል። ዝተገደደ tool_choice ብዝተሃንደሱ open-weight ሞዴላት ይትግበር። ግብር ጥሪ
• ስእሊ ኣተዋዕዎ. እቲ ሞዴል ኣብ ውሽጢ user መልእኽቲ ዝተላእኩ ስእልታት ከም data URL ወይ ከም ኣድራሻ የንብብ። shannon-2-lite ከምኡውን shannon-2-pro ስእልታት ኣብ ጠለባት tools ወይ response_format ዝልእኹ እውን የንብቡ። ስድራ Shannon 3 ሰነዳት እውን የንብብ። ስእልታትን ፋይላትን
• Reasoning. እቲ ምላሽ ጽሑፍ reasoning ናይ ሞዴል ኣብ ጥቓ እቲ መልሲ፣ ኣብ ናቱ field ክሕዝ ይኽእል። Reasoning effort
• Reasoning effort. ናይ ጠለብ field እቲ ሞዴል ክሳብ ክንደይ ዓሚቝ ከም ዝሓስብ የዘጋጅ፦ off፣ low፣ medium ወይ high። ሞዴላት Shannon ዓሚቝነቶም ባዕሎም የዘጋጁ። Reasoning effort
• JSON object. ብ response_format: {"type": "json_object"} እቲ መልሲ ብዘይ ዝተወሰነ ቅርጺ JSON እዩ። ኣብ /v1/chat/completions ከምኡውን /v1/responses። የተዋቀረ ውጤት
• JSON schema. ብ response_format ዓይነት json_schema እቲ መልሲ ዝልእኽዎ schema ይስዕብ። ኣብ /v1/chat/completions ከምኡውን /v1/responses። የተዋቀረ ውጤት
• Prompt caching. ኣብ ተመሳሳሊ ሞዴል ከም ቀረባ ጠለብ ዝጅምር prompt ካብ cache ይነበብ፣ እቲ cached ክፍሊ ድማ ብ25% ናይ ዋጋ ኣተዋዕዎ ይኽፈል። ናይ ጠለብ field ኣየድልዮን። Prompt caching
• Web ድሌት. ብ web_search: true እቲ API ኣብ web ይደሊ እሞ ቅድሚ ምምላሱ ውጽኢታት ንሞዴል ይህብ። ኣብ /v1/chat/completions ከምኡውን /v1/messages። ናይ ጠለብ field እዩ ከምኡውን ኣብ GET /v1/models flag የብሉን። የድር ፍለጋ
• Streaming. ብ stream: true እቲ ምላሽ እቲ ሞዴል ክጽሕፍ ከሎ ከም server-sent events ይመጽእ። ነፍሲ ወከፍ ሞዴል ኣብ ኩሎም ሰለስተ endpoints streaming ይገብር። ስትሪም

ተመሳሳሊ ሓቅታት ካብ GET /v1/models

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

GET /v1/models ነፍሲ ወከፍ ሞዴል ምስ capabilities object ይዝርዝር፣ ስለዚ ፕሮግራም ካብ እዚ ገጽ ክንዲ እዞም ሓቅታት ከንብብ ይኽእል። እቲ 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

እቲ id ከምኡውን capabilities ናይ ክልተ entries ናይ data፦

[
  {
    "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
    }
  }
]

• response_format ከምኡውን prompt_caching flags ናይ ዝተሃንደሱ open-weight entries እዮም። Shannon entry JSON ውጽኢት ብ json_schema ጥራይ ይሕብር፣ እዚ ንክልቲኦም JSON modes ይወክል።
• vision ንሞዴላት shannon-2-lite ከምኡውን shannon-2-pro true እዩ፦ ብተወሳኺ tools ወይ response_format ኣብ ዝልእኹ ጠለባት እውን ስእልታት የንብቡ።

ካብ ረድፊ ሞዴል ወጻኢ

ዝተሃንደሰ open-weight ሞዴል ካብ ረድፉ ወጻኢ ዘለዉ ስእሊ ወይ JSON mode ይነጽግ። ምንጻግ ቅድሚ ካብ ሚዛንካ ዝውሰድ ዝኾነ ይመጽእ፦

ሞዴል Shannon ንከምዚ ዝበለ ጠለብ ብኩነታት 200 ይምልሶ፦ ካብ ረድፉ ወጻኢ ዘሎ ክእለት ኣብ መልሲ ኣይሳተፍን። ሓጋይ ኣስተዳደር