وړتیاوې

هر ماډل د API له لارې څه کولی شي، ماډل په ماډل: tools، انځور input، reasoning، JSON output، prompt caching، web search او streaming.

هر ماډل د هماغه درې endpoints له لارې او هماغه کیلي سره لاسرسی لري. دوه جدولونه ښیي چیرته ماډلونه توپیر لري. کرښه معنی لري چې ماډل پرته له دې وړتیا ځواب ورکوي.

د Shannon ماډلونه

ماډل	Tools	انځورونه	Reasoning	Effort	JSON object	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 د هغه نوم او variant دی چې د hyphen سره یوځای شوي، د مثال په توګه DeepSeek-V4-Pro-0813-3BIT-REAP.

ماډل	Tools	انځورونه	Reasoning	Effort	JSON object	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. تاسو functions په tools کې بیانوئ، ماډل هغه calls ته ځواب ورکوي چې غواړي وشي، او ستاسو کوډ یې چلوي. هر ماډل tools مني. زور شوی tool_choice د کوربه شوو open-weight ماډلونو لخوا پلي کیږي. فنکشن زنګ وهل
انځور input. ماډل هغه انځورونه لولي چې د user message دننه لیږل کیږي، د data URL یا د پتې په توګه. shannon-2-lite او shannon-2-pro انځورونه په هغه غوښتنو کې لولي چې tools یا response_format هم لیږي. د Shannon 3 کورنۍ اسناد هم لولي. انځورونه او فایلونه
Reasoning. ځواب کولی شي د ماډل د reasoning متن د ځواب تر څنګ، په جلا ساحه کې، ولیږدوي. د reasoning effort
Reasoning effort. د غوښتنې یوه ساحه ټاکي چې ماډل څومره ژور reasoning کوي: off، low، medium یا high. د Shannon ماډلونه خپل ژوروالی پخپله ټاکي. د reasoning effort
JSON object. د 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. د 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))

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 object	`response_format`
JSON schema	`json_schema`
Prompt caching	`prompt_caching`
Web search	flag نه دی: د غوښتنې ساحه `web_search`.
Streaming	`streaming`

response_format او prompt_caching د کوربه شوو open-weight داخلو flags دي. د Shannon داخله JSON output یوازې د json_schema سره راپور کوي، چې د دواړو JSON modes استازیتوب کوي.
vision د shannon-2-lite او shannon-2-pro لپاره true دی: دوی هغه غوښتنو کې انځورونه لولي چې tools یا response_format هم لیږي.

د ماډل له قطار بهر

کوربه شوی open-weight ماډل هغه انځور یا JSON mode رد کوي چې د هغه له قطار بهر وي. رد کول مخکې له دې راځي چې ستاسو له بیلانس څخه څه کم شي:

حالت	ډول	پیغام	کله
`400`	`invalid_request_error`	`<id> does not accept image input`	انځور هغه کوربه شوي open-weight ماډل ته ولیږل شو چې انځور input نه لري.
`400`	`invalid_request_error`	`<id> does not accept response_format`	د JSON output غوښتنه د کوربه شوي open-weight ماډل څخه شوه چې هیڅ JSON mode نه لري.
`400`	`invalid_request_error`	`<id> does not accept response_format json_schema; use json_object`	schema هغه کوربه شوي open-weight ماډل ته ولیږل شو چې یوازې JSON object mode لري.

د Shannon ماډل چې داسې غوښتنې ته په حالت 200 ځواب ورکوي: هغه وړتیا چې د هغه له قطار بهر وي په ځواب کې برخه نه اخلي. د تېروتنې اداره کول