Changelog
Cusbooneysiinta iyo hagaajinta dhow ee Shannon API.
Boggani wuxuu liis garaynayaa isbeddellada aad u arki karto sidii wacaha API-ga: endpoint-yo cusub, field-yo iyo model-yo, dabeecad la beddelay iyo hagaajin. Gelinnada ugu cusub ayaa marka hore. Gelin kasta waxay sidaa taariikhda isbeddelka la sameeyay.
Gelin lagu calaamadeeyay Jebinta waxay beddeli kartaa natiijada codsi hore u shaqayn jiray. API-gu wuxuu leeyahay hal nooc, /v1, sidaas darteed isbeddellada waxaa lagu liis garaynayaa taariikh ma aha lambarka nooca.
- Cusub
Codsi leh
web_search: truewuxuu magacaabaa ilihiisa:sourcesee/v1/chat/completionsiyo/v1/messageswaxay liis garaysaa natiijooyinka model-ka la siiyay,annotationsee/v1/chat/completionsna waxay calaamadeysaa halka jawaabtu mid kasta ku xustay. Ku-dhismay Raadinta Shabakadda
- Cusub
web_search: true/v1/chat/completionsiyo/v1/messageswuxuu orodsiiyaa raadin web ka hor inta model-ku jawaabin wuxuuna natiijooyinka siiyaa sida ilo tiro leh. Codsi natiijo helay wuxuu isticmaalaa hal raadin allowance-kaaga maalinle. Haddii wax ka hadhin, codsiga waxaa lagu jawaabaa raadin la'aan. Ku-dhismay Raadinta Shabakadda
- go'an
Stream dhinaca server-ka laga gooyay waxaa lagu dallacaa isticmaalka la sheegay ilaa meeshaas. Inta kale ee keydka waxay ku noqotaa haraagaaga.
- go'an
shannon-coder-1wuxuu ka jawaabaa/v1/responsessida labada endpoint ee kale. Qalabka CLI ee coding-ka - go'an
Furaha API ee la beddelay isla markiiba wuu joogsadaa.
- Cusub
POST /v1/tokenizeiyoPOST /v1/messages/count_tokens: tirinta token-yada oo bilaash ah model-yada open-weight ee la martigeliyo. Tirinta token-yada - Cusub
Prompt caching model-yada open-weight ee la martigeliyo. Input cached waxaa lagu dallacaa 25% qiimaha input-ka waxaana lagu sheegaa
usagesaddexda endpoint:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensiyocache_read_input_tokens.GET /v1/modelswuxuu model-yadan u sheegaapricing.cached_input_per_million_usdiyocapabilities.prompt_caching. Kaydinta Prompt-ka - go'an
Model-yada open-weight ee la martigeliyo:
tool_choicekhasbay (requiredama function la magacaabay) wuxuu soo saaraa wicitaan tool. Wacyigelinta Shaqada - go'an
Model-yada open-weight ee la martigeliyo waxay aqbalaan fariin
systemah oo aan ahayn fariinta ugu horreysa ee wada-hadalka.
- Cusub
API-ga waxaa laga gaari karaa sida Tor onion service iyo cinwaan I2P. Jawaabaha
api.shannon-ai.comwaxay labada cinwaan ku sidaan header-yadaOnion-LocationiyoX-I2P-Location. Endpoint-yo sir-geliyay, Tor & I2P
- Cusub
Model-yo cusub
shannon-3.1iyoshannon-3.1-pro, ooGET /v1/modelsliis garaynayo. Model-yo & qiimo - La beddelay
Codsi stream ah oo macmiilkiisu go'o wuxuu ordaa ilaa dhammaadkiisa waana la tiriyaa. Hore, jawaabtu waxay istaagi jirtay goynta.
- go'an
Codsiyada
/v1/responseswaxay ka muuqdaan diiwaanka isticmaalka.
- Cusub
Model-yada open-weight ee la martigeliyo waxay dabaqaan field-yada sampling:
temperature,top_p,seed,stopiyomax_tokens/v1/chat/completions;temperature,top_piyostop_sequences/v1/messages;temperature,top_piyomax_output_tokens/v1/responses. Chat Completions - Cusub
Diiwaanka isticmaalku wuxuu muujiyaa kharash USD ah wicitaan kasta iyo wadar ahaan.
- Jebinta
Qiimaha
modelee aan ahayn id la daabacay waxaa lagu jawaabaa400, noocainvalid_request_erroriyo fariintaunknown model: <id>saddexda endpoint. Hore, codsi sidaas ah waxaa ka jawaabi jirayshannon-1.6-lite. Model-yo & qiimo - Jebinta
/v1wuxuu qaataa fure API oo keliya. Cookie-ga gelitaanka website-ka halkaas lama akhriyo. Xaqiijinta - La beddelay
Flood protection: 120 codsi daqiiqad kasta akoon kasta saddexda endpoint ee abuurista. Xadad iyo haraag
- La hagaajiyay
Marka model-ku jawaabi waayo, khaladku wuxuu sidaa fariinta go'an
The model backend failed to answer. Please retry.Hubinta haraag oo aan la samayn karin waxaa lagu jawaabaa503iyo noocaapi_error. Khaladaadka Maareynta - go'an
Codsi aan stream ahayn oo fashilma wuxuu keydkiisa ku celiyaa haraagaaga.
- Cusub
GET /v1/modelswuxuu model kasta u sheegaacapabilities.reasoning_effort. Effort-ka reasoning-ka - La hagaajiyay
Model-yada open-weight ee la martigeliyo: codsi aan stream ahayn oo jawaab helin wuxuu ku dhammaadaa
504iyo noocaapi_error. Natiijo madhan waa502. Khaladaadka Maareynta
- Jebinta
Model-yada open-weight ee la martigeliyo waxay qaataan input-ka model-ka la magacaabay qaato. Sawir loo diray id qoraal oo keliya waxaa lagu jawaabaa
400iyo<id> does not accept image input.response_formatid aan lahayn structured output waxaa lagu jawaabaa400.GET /v1/modelswuxuu id kasta u sheegaacapabilities.vision,response_formatiyojson_schema. Sawirro iyo faylal - go'an
Jawaabaha aan stream ahayn waxay sidaan qoraalka reasoning-ka:
reasoning_contentfariinta/v1/chat/completions, iyo blockthinkingqoraalka ka hor/v1/messages. Effort-ka reasoning-ka - La beddelay
Model-yada open-weight ee la martigeliyo waxay leeyihiin qiimayaal cusub, laga bilaabo $0.50 halkii 1M input token iyo $2.00 halkii 1M output token. Model-yo & qiimo
- La beddelay
Model-yada open-weight ee la martigeliyo waxay leeyihiin hal id model kasta, laba iyo toban id wadar ahaan. Model-yo & qiimo
- Cusub
Structured output ee
shannon-3,shannon-3-pro,shannon-3.1iyoshannon-3.1-pro.GET /v1/modelswuxuu iyaga u sheegaacapabilities.json_schema: true. Waxsoosaarka qaabaysan - Cusub
/v1/responseswuxuu akhriyaatext.format(json_objectamajson_schema) structured output. Responses API - go'an
/v1/responseswuxuu soo celiyaa reasoning-ka model-yada Shannon: shay outputreasoningah ka hor shaygamessage, iyo events-ka streamresponse.reasoning_summary_text.deltaiyoresponse.reasoning_summary_text.done. Responses API - go'an
Field-ka
modelee jawaabtu waa id-ga la daabacay endpoint kasta. Shayga Responses wuxuu sidaamodeliyocreated_at. - La hagaajiyay
GET /v1/modelswuxuu sheegaa context window-ga model kasta. Model-yo & qiimo
- Cusub
Model-yada open-weight ee la martigeliyo way ka jawaabaan
/v1/messagesiyo/v1/responsesiyo/v1/chat/completions, iyagoo leh system prompt-kaaga iyo wicitaannada tool./v1/messageswuxuu qaataathinking,reasoning_effortwaa field codsi. Model-yo & qiimo - La hagaajiyay
Jidhka khaladaadka
/v1wuxuu raacaa qaababka SDK: shayerroroo lehtypeiyomessageendpoint-yada qaabka OpenAI, iyo isla shaygaas{"type": "error"}dhexdiisa/v1/messages. Khaladaadka Maareynta - Cusub
Keep-alive streams-ka furan 15 ilbiriqsi kasta: xariiq faallo ah
: ping/v1/chat/completions,event: ping/v1/messages. Streaming - La beddelay
Id-yada wicitaanka tool waxay ku bilaabmaan
call_/v1/chat/completionsiyo/v1/responses, iyotoolu_/v1/messages. Wacyigelinta Shaqada - Jebinta
/v1/responses:streamdefault-kiisu waafalse. Responses API - Cusub
max_completion_tokenswaa la aqbalaa sida magac kale oomax_tokensah/v1/chat/completions. Chat Completions - go'an
Event-ka
response.completedee stream-ka Responses wuxuu sidaa array-gaoutput. Responses API - Cusub
Gelinnada
GET /v1/modelswaxay sidaandisplay_name,context_window,max_output_tokens,pricing,capabilitiesiyoendpoints. Model-yo & qiimo - Cusub
Jawaab kasta waxay sidaa
x-request-id, qiimaha aad dirtana waa la soo celiyaa. Jidhka codsiyada wuxuu noqon karaa ilaa 32 MiB. - Cusub
Furaha waa la meel mari karaa iyadoo fure cusub aan la bixin. Diiwaanka isticmaalka waa bog-bog.
- Cusub
Sawirro iyo dukumentiyo codsiyada dhexdooda: qaybaha
image_urlee/v1/chat/completions, blocks-kaimage,documentiyofileee/v1/messages, qaybahainput_imageee/v1/responses. Sawirro iyo faylal - Cusub
Model cusub
shannon-3-pro. Model-yo & qiimo
- Cusub
Model cusub
shannon-3. Model-yo & qiimo - Cusub
Streams-ka
/v1/chat/completionswaxay reasoning-ka ku sidaandelta.reasoning_content. Effort-ka reasoning-ka
- La beddelay
max_tokenswaxaa lagu hayaa 1 ilaa 65,536. Qiime ka baxsan xadkaas waxaa loo keenaa dhammaadka ugu dhow, lama diido. Chat Completions
- Cusub
shannon-coder-1waxaa lagu tiriyaa wicitaanno qorshe kasta/v1/chat/completionsiyo/v1/messages. Marka wicitaannada daaqad la isticmaalo, jawaabtu waa429oo leh fariintaShannon Coder call quota reached. Qalabka CLI ee coding-ka - Cusub
Wada-hadal ka weyn context window waxaa lagu jawaabaa
400, noocainvalid_request_erroriyo code-kacontext_length_exceeded. Khalad stream dhexdiisa ah wuxuu u yimaadaa sida event khalad ah, ma aha qoraal jawaabta ku jira. Qalabka CLI ee coding-ka
- Cusub
Endpoint-yada
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesiyoGET /v1/models. Waa endpoint-yada ay wacaan SDK-yada OpenAI iyo Anthropic, Claude Code iyo Codex CLI. Dulmar - Cusub
Wicitaannada tool ee
toolsku saabsan/v1/chat/completionsiyo/v1/messages, structured output ooresponse_formatleh, iyosystemsida string ama sida blocks qoraal ah/v1/messages. Wacyigelinta Shaqada
- Cusub
Id-yada model-ka
shannon-1.6-pro,shannon-2-lite,shannon-2-proiyoshannon-coder-1,shannon-1.6-liteagtiisa. Model-yo & qiimo
- Cusub
Soo saarkii ugu horreeyay ee API-ga: chat qaabka OpenAI iyo qaabka Anthropic, iyo endpoint Responses, mid kastaa waxaa lagu wacaa furaha API ee ku bilaabma
sk-. Xaqiijinta