Yiya kumxholo
Izakhono

Izakhono

Oko imodeli nganye ikwaziyo ukukwenza nge-API, imodeli ngemodeli: ii-tool, i-image input, ukuqiqa, i-JSON output, i-prompt caching, ukufuna kwiwebhu kunye ne-streaming.

Yonke imodeli ifikelelwa nge-endpoint ezintathu ezifanayo ngesitshixo esifanayo. Iitheyibhile ezimbini zibonisa apho iimodeli zahluka khona. Umgca ongqamene ubonisa ukuba imodeli iphendula ngaphandle kwaloo sakhono.

Iimodeli zeShannon

Imodeli Ii-toolImifanekisoUkuqiqaI-EffortJSON objectJSON schemaI-CachingUkufunaI-Streaming
shannon-1.6-lite EweEwe——EweEwe—EweEwe
shannon-1.6-pro EweEweEwe—EweEwe—EweEwe
shannon-2-lite Ewe—Ewe—EweEwe—EweEwe
shannon-2-pro Ewe—Ewe—EweEwe—EweEwe
shannon-3 EweEweEwe—EweEwe—EweEwe
shannon-3-pro EweEweEwe—EweEwe—EweEwe
shannon-3.1 EweEweEwe—EweEwe—EweEwe
shannon-3.1-pro EweEweEwe—EweEwe—EweEwe
shannon-3.5 Ewe———EweEwe——Ewe
shannon-coder-1 Ewe—Ewe—EweEwe——Ewe

Iimodeli ze-open-weight ezisingathiweyo

I-id yemodeli esingathiweyo yigama layo nohlobo lwayo oludityaniswe yihayifeni, umzekelo i-DeepSeek-V4-Pro-0813-3BIT-REAP.

Imodeli Ii-toolImifanekisoUkuqiqaI-EffortJSON objectJSON schemaI-CachingUkufunaI-Streaming
DeepSeek-V4-Pro-0813 3BIT-REAP Ewe—EweEweEweEweEwe—Ewe
GLM-5.2 3BIT-REAP Ewe—EweEweEweEweEwe—Ewe
Kimi-K3 3BIT-REAP EweEweEweEweEweEweEwe—Ewe
Nemotron3Ultra 3BIT-REAP Ewe—EweEweEweEweEwe—Ewe
MiniMax-M3 3BIT-REAP EweEweEweEweEweEweEwe—Ewe
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP Ewe—EweEweEweEweEwe—Ewe
Kimi-K2.6 W4A16-AUTOROUND-REAP EweEweEweEweEweEweEwe—Ewe
Laguna-S-2.1 W4A16-AUTOROUND-REAP Ewe—EweEwe——Ewe—Ewe
inkling W4A16-AUTOROUND-REAP EweEweEweEweEwe—Ewe—Ewe
MiMo-V2.5-Pro W8A16 Ewe—EweEweEweEweEwe—Ewe
MiMo-V2.5 W8A16 EweEweEweEweEweEweEwe—Ewe
Hy3 W8A16 Ewe—EweEweEweEweEwe—Ewe

Oko ikholamu nganye ikuthethayo

  • Ii-tool. Uchaza imisebenzi kwi-tools, imodeli iphendula ngobizo oluyifunayo, kwaye ikhowudi yakho iyaluqhuba. Yonke imodeli yamkela ii-tool. I-tool_choice enyanzelweyo isetyenziswa ziimodeli ze-open-weight ezisingathiweyo. Umsebenzi Ukufowuna
  • I-image input. Imodeli ifunda imifanekiso ethunyelwe ngaphakathi kumyalezo womsebenzisi, njenge-data URL okanye njengedilesi. I-shannon-2-lite ne-shannon-2-pro zifunda imifanekiso kwizicelo ezithumela kwakhona i-tools okanye i-response_format. Intsapho yeShannon 3 ifunda noxwebhu. Imifanekiso neefayile
  • Ukuqiqa. Impendulo inokuthwala umbhalo wokuqiqa wemodeli ecaleni kwempendulo, kwintsimi yayo. I-effort yokuqiqa
  • I-effort yokuqiqa. Intsimi yesicelo imisela ukuba imodeli iqiqa nzulu kangakanani: off, low, medium okanye high. Iimodeli zeShannon zizimisela ubunzulu bazo. I-effort yokuqiqa
  • JSON object. Nge-response_format: {"type": "json_object"} impendulo yi-JSON engenasimo emiselweyo. Kwi-/v1/chat/completions nakwi-/v1/responses. Iziphumo ezicwangcisiweyo
  • JSON schema. Nge-response_format yohlobo lwe-json_schema impendulo ilandela i-schema oyithumelayo. Kwi-/v1/chat/completions nakwi-/v1/responses. Iziphumo ezicwangcisiweyo
  • I-Prompt caching. I-prompt eqala njengesandula ukuba khona kwimodeli enye ifundwa kwi-cache, kwaye inxalenye egcinwe ihlawulwa kwi-25% yexabiso le-input. Ayifuni ntsimi yesicelo. I-Prompt caching
  • Ukufuna kwiwebhu. Nge-web_search: true i-API ifuna kwiwebhu kwaye inika imodeli iziphumo phambi kokuphendula. Kwi-/v1/chat/completions nakwi-/v1/messages. Yintsimi yesicelo kwaye ayinayo i-flag kwi-GET /v1/models. Uphendlo lwewebhu olwakhelwe ngaphakathi
  • I-Streaming. Nge-stream: true impendulo ifika njengemisitho ethunyelwe yi-server ngoxa imodeli ibhala. Yonke imodeli i-stream kuzo zontathu ii-endpoint. Umsinga

Ezo nkcukacha ziyafana ukusuka kwi-GET /v1/models

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

I-GET /v1/models idwelisa yonke imodeli kunye ne-capabilities object, ukuze inkqubo ifunde ezi nkcukacha endaweni yeli phepha. I-endpoint ayifuni sitshixo.

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

I-id ne-capabilities yeempawu ezimbini ze-data:

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
    }
  }
]
Ikholamu I-flag kwi-capabilities
Ii-tool tools
I-image input vision
Ukuqiqa reasoning
I-effort yokuqiqa reasoning_effort
JSON object response_format
JSON schema json_schema
I-Prompt caching prompt_caching
Ukufuna kwiwebhu Ayiyiyo i-flag: intsimi yesicelo i-web_search.
I-Streaming streaming
  • I-response_format ne-prompt_caching zii-flag zeempawu ze-open-weight ezisingathiweyo. Impawu yeShannon ixela i-JSON output nge-json_schema kuphela, emele zombini iimo ze-JSON.
  • I-vision yi-true kwi-shannon-2-lite ne-shannon-2-pro: zifunda imifanekiso kwizicelo ezithumela kwakhona i-tools okanye i-response_format.

Ngaphandle komgca wemodeli

Imodeli ye-open-weight esingathiweyo iyala umfanekiso okanye imo ye-JSON engaphandle komgca wayo. Ukwala kuza phambi kokuba kuthathwe nantoni na kwibhalansi yakho:

Isimo Uhlobo Umyalezo Xa
400 invalid_request_error <id> does not accept image input Umfanekiso uthunyelwe kwimodeli ye-open-weight esingathiweyo engenayo i-image input.
400 invalid_request_error <id> does not accept response_format I-JSON output iceliwe kwimodeli ye-open-weight esingathiweyo engenayo nayiphi na imo ye-JSON.
400 invalid_request_error <id> does not accept response_format json_schema; use json_object I-schema ithunyelwe kwimodeli ye-open-weight esingathiweyo enemo ye-JSON object kuphela.

Imodeli yeShannon iphendula isicelo esinjalo ngesimo 200: isakhono esingaphandle komgca wayo asithathi nxaxheba kwimpendulo. Ukuphatha imposiso