U gudub nuxurka
Awoodaha

Awoodaha

Waxa model kasta sameyn karo API-ga, model-ba model: tools, gelinta sawirka, reasoning, output JSON ah, prompt caching, raadinta webka iyo streaming.

Model kasta waxaa laga gaaraa isla saddexda endpoint iyo isla furaha. Labada shaxdood waxay tusaan halka model-yadu ku kala duwan yihiin. Xariiqdu waxay la macno tahay in model-ku ka jawaabo awoodaas la'aanteed.

Model-yada Shannon

Model ToolsSawirroReasoningEffortShay JSONJSON schemaCachingRaadinStreaming
shannon-1.6-lite HaaHaa——HaaHaa—HaaHaa
shannon-1.6-pro HaaHaaHaa—HaaHaa—HaaHaa
shannon-2-lite Haa—Haa—HaaHaa—HaaHaa
shannon-2-pro Haa—Haa—HaaHaa—HaaHaa
shannon-3 HaaHaaHaa—HaaHaa—HaaHaa
shannon-3-pro HaaHaaHaa—HaaHaa—HaaHaa
shannon-3.1 HaaHaaHaa—HaaHaa—HaaHaa
shannon-3.1-pro HaaHaaHaa—HaaHaa—HaaHaa
shannon-3.5 Haa———HaaHaa——Haa
shannon-coder-1 Haa—Haa—HaaHaa——Haa

Model-yada open-weight ee la martigeliyo

Id-ga model la martigeliyay waa magaciisa iyo nooca isaga oo xarriiq ku xiran, tusaale ahaan DeepSeek-V4-Pro-0813-3BIT-REAP.

Model ToolsSawirroReasoningEffortShay JSONJSON schemaCachingRaadinStreaming
DeepSeek-V4-Pro-0813 3BIT-REAP Haa—HaaHaaHaaHaaHaa—Haa
GLM-5.2 3BIT-REAP Haa—HaaHaaHaaHaaHaa—Haa
Kimi-K3 3BIT-REAP HaaHaaHaaHaaHaaHaaHaa—Haa
Nemotron3Ultra 3BIT-REAP Haa—HaaHaaHaaHaaHaa—Haa
MiniMax-M3 3BIT-REAP HaaHaaHaaHaaHaaHaaHaa—Haa
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP Haa—HaaHaaHaaHaaHaa—Haa
Kimi-K2.6 W4A16-AUTOROUND-REAP HaaHaaHaaHaaHaaHaaHaa—Haa
Laguna-S-2.1 W4A16-AUTOROUND-REAP Haa—HaaHaa——Haa—Haa
inkling W4A16-AUTOROUND-REAP HaaHaaHaaHaaHaa—Haa—Haa
MiMo-V2.5-Pro W8A16 Haa—HaaHaaHaaHaaHaa—Haa
MiMo-V2.5 W8A16 HaaHaaHaaHaaHaaHaaHaa—Haa
Hy3 W8A16 Haa—HaaHaaHaaHaaHaa—Haa

Waxa tiir kasta macnaheedu yahay

  • Tools. Waxaad functions ku sharaxdaa tools, model-ku wuxuu ku jawaabaa wicitaannada uu rabo in la sameeyo, code-kaaguna wuu ordaa. Model kasta wuu qaataa tools. tool_choice khasbay waxaa dabaqa model-yada open-weight ee la martigeliyo. Wacyigelinta Shaqada
  • Gelinta sawirka. Model-ku wuxuu akhriyaa sawirrada fariinta isticmaalaha ku jira, sida data URL ama cinwaan. shannon-2-lite iyo shannon-2-pro waxay akhriyaan sawirro codsiyada sidoo kale diraya tools ama response_format. Qoyska Shannon 3 wuxuu akhriyaa dukumentiyo sidoo kale. Sawirro iyo faylal
  • Reasoning. Jawaabtu waxay ku sidi kartaa qoraalka reasoning-ka model-ka jawaabta agteeda, field u gaar ah dhexdiisa. Effort-ka reasoning-ka
  • Reasoning effort. Field codsi ayaa dejiya inta model-ku fikirka ka qoto dheeriyo: off, low, medium ama high. Model-yada Shannon waxay dejiyaan qoto-dheerida iyaga u gaar ah. Effort-ka reasoning-ka
  • Shay JSON. Marka response_format: {"type": "json_object"} jawaabtu waa JSON aan lahayn qaab la qoray. Ka shaqeeya /v1/chat/completions iyo /v1/responses. Waxsoosaarka qaabaysan
  • JSON schema. Marka response_format yahay nooca json_schema jawaabtu waxay raacdaa schema aad dirto. Ka shaqeeya /v1/chat/completions iyo /v1/responses. Waxsoosaarka qaabaysan
  • Prompt caching. Prompt ku bilaabma sida mid dhow oo isla model ah waxaa laga akhriyaa cache, qaybta cached-na waxaa lagu dallacaa 25% qiimaha input-ka. Field codsi looma baahna. Kaydinta Prompt-ka
  • Raadinta webka. Marka web_search: true API-gu wuxuu raadiyaa webka wuxuuna natiijooyinka siiyaa model-ka ka hor inta uusan jawaabin. Ka shaqeeya /v1/chat/completions iyo /v1/messages. Waa field codsi oo calan kuma laha GET /v1/models. Ku-dhismay Raadinta Shabakadda
  • Streaming. Marka stream: true jawaabtu waxay timaadaa sida server-sent events inta model-ku qoranayo. Model kasta wuu stream-gareeyaa dhammaan saddexda endpoint. Streaming

Isla xaqiiqooyinka GET /v1/models

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

GET /v1/models wuxuu liis garaynayaa model kasta oo leh shay capabilities, sidaas darteed barnaamij wuxuu akhrin karaa xaqiiqooyinkan halkii uu bogga ka akhrin lahaa. Endpoint-ku fure ma u baahna.

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))

id iyo capabilities ee laba gelin oo data ah:

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
    }
  }
]
Tiir Calanka capabilities
Tools tools
Gelinta sawirka vision
Reasoning reasoning
Reasoning effort reasoning_effort
Shay JSON response_format
JSON schema json_schema
Prompt caching prompt_caching
Raadinta webka Ma aha calan: field-ka codsiga web_search.
Streaming streaming
  • response_format iyo prompt_caching waa calamo gelinnada open-weight ee la martigeliyo. Gelinta Shannon waxay output-ka JSON ku sheegtaa json_schema keliya, kaas oo u taagan labada JSON mode.
  • vision waa true shannon-2-lite iyo shannon-2-pro: waxay akhriyaan sawirro codsiyada sidoo kale diraya tools ama response_format.

Ka baxsan safka model-ka

Model open-weight oo la martigeliyay wuxuu diidaa sawir ama JSON mode ka baxsan safkiisa. Diidmadu waxay timaadaa ka hor inta wax laga qaadin haraagaaga:

Xaalad Nooc Fariin Goorta
400 invalid_request_error <id> does not accept image input Sawir ayaa loo diray model open-weight oo la martigeliyay oo aan aqbalin gelinta sawirka.
400 invalid_request_error <id> does not accept response_format Output JSON ah ayaa laga codsaday model open-weight oo la martigeliyay oo aan lahayn labada JSON mode midna.
400 invalid_request_error <id> does not accept response_format json_schema; use json_object Schema ayaa loo diray model open-weight oo la martigeliyay oo leh JSON object mode oo keliya.

Model Shannon wuxuu ka jawaabaa codsi sidaas ah xaalad 200: awoodda ka baxsan safkiisa ma qaadato qayb jawaabta. Khaladaadka Maareynta