Clàr-atharrachaidh
Ùrachaidhean is leasachaidhean o chionn ghoirid air Shannon API.
Tha an duilleag seo a’ liostadh na h-atharrachaidhean a chì thu mar neach a ghairmeas an API: endpoints, raointean is modailean ùra, giùlan atharraichte agus càraidhean. Thig na h-inntrigidhean as ùire an toiseach. Tha ceann-latha na h-atharrachaidh aig gach inntrigeadh.
Faodaidh inntrigeadh a tha air a chomharrachadh Briseadh toradh iarrtais a dh’obraich roimhe atharrachadh. Tha aon tionndadh aig an API, /v1, agus mar sin tha na h-atharrachaidhean air an liostadh a-rèir ceann-latha seach àireamh tionndaidh.
- Ùr
Bidh iarrtas le
web_search: trueag ainmeachadh a thùsan: thasourcesair/v1/chat/completionsagus/v1/messagesa’ liostadh nan toraidhean a fhuair am modail, agus air/v1/chat/completionsthaannotationsa’ comharrachadh càite a bheil am freagairt ag iomradh air gach fear dhiubh. Rannsachadh Lìn air a thoirt a-steach
- Ùr
Ruithidh
web_search: trueair/v1/chat/completionsagus/v1/messagesrannsachadh lìn mus freagair am modail agus bheir e na toraidhean dha mar stòran àireamhaichte. Cleachdaidh iarrtas a lorg toraidhean aon rannsachadh dhen chuibhreann làitheil agad. Mura h-eil gin air fhàgail, thèid an t-iarrtas a fhreagairt gun rannsachadh. Rannsachadh Lìn air a thoirt a-steach
- Chàirich
Thèid stream a thèid a ghearradh aig taobh an server a bhilleadh airson an usage a chaidh aithris suas chun na h-ìre sin. Till an còrr dhen ghlèidheadh dhan bhalance agad.
- Chàirich
Freagraidh
shannon-coder-1air/v1/responsesmar a nì e air an dà endpoint eile. Innealan còdachaidh CLI - Chàirich
Stadaidh iuchair API a chaidh ùrachadh sa bhad.
- Ùr
POST /v1/tokenizeagusPOST /v1/messages/count_tokens: cunntasan token an-asgaidh airson nam modailean open-weight hosted. Cunntadh tokens - Ùr
Prompt caching air na modailean open-weight hosted. Thèid input cached a bhilleadh aig 25% de phrìs an input agus a thoirt cunntas ann an
usageair na trì endpoints:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensaguscache_read_input_tokens. BheirGET /v1/modelscunntas airpricing.cached_input_per_million_usdaguscapabilities.prompt_cachingairson nam modailean sin. Caching prompt - Chàirich
Modailean open-weight hosted: bheir
tool_choiceèigneachail (requiredno gnìomh ainmichte) gairm inneil. Call gnìomh - Chàirich
Gabhaidh modailean open-weight hosted ri teachdaireachd
systemnach i a’ chiad teachdaireachd dhen chòmhradh.
- Ùr
Gheibhear an API mar sheirbheis onion Tor agus aig seòladh I2P. Bidh an dà sheòladh ann an headers
Onion-LocationagusX-I2P-Locationaig freagairteanapi.shannon-ai.com. Endpoints crioptaichte, Tor & I2P
- Ùr
Modailean ùra
shannon-3.1agusshannon-3.1-pro, air an liostadh leGET /v1/models. Modailean & prìsean - Air atharrachadh
Ruithidh iarrtas streamte a dhì-cheanglas an client aige gu a cheann agus thèid a chunntadh. Roimhe sin, stad am freagairt aig an dì-cheangal.
- Chàirich
Nochdaidh iarrtasan gu
/v1/responsesanns an loga usage.
- Ùr
Cuiridh modailean open-weight hosted na raointean samplachaidh an sàs:
temperature,top_p,seed,stopagusmax_tokensair/v1/chat/completions;temperature,top_pagusstop_sequencesair/v1/messages;temperature,top_pagusmax_output_tokensair/v1/responses. Chat Completions - Ùr
Seallaidh an loga usage cosgais ann an USD airson gach gairm agus mar iomlan.
- Briseadh
Thèid luach
modelnach e id foillsichte a th’ ann a fhreagairt le400, an seòrsainvalid_request_erroragus an teachdaireachdunknown model: <id>air na trì endpoints. Roimhe sin, fhreagairshannon-1.6-liteiarrtas mar sin. Modailean & prìsean - Briseadh
Cha ghabh
/v1ach ri iuchair API. Cha tèid cookie clàraidh a-steach na làraich-lìn a leughadh an sin. Dearbhadh - Air atharrachadh
Dìon thar-thuiltidh: 120 iarrtas gach mionaid gach cunntais air na trì endpoints gineadh. Crìochan agus balance
- Leasaichte
Nuair nach urrainn dhan mhodail freagairt, tha an teachdaireachd stèidhichte
The model backend failed to answer. Please retry.sa mhearachd. Thèid sgrùdadh balance nach gabh a dhèanamh a fhreagairt le503agus an seòrsaapi_error. Làimhseachadh mearachd - Chàirich
Bheir iarrtas gun streaming a dh’fhailicheas an glèidheadh aige air ais dhan bhalance agad.
- Ùr
Bheir
GET /v1/modelscunntas aircapabilities.reasoning_effortairson gach modail. Oidhirp reusanachaidh - Leasaichte
Modailean open-weight hosted: thig iarrtas gun streaming nach fhaigh freagairt gu crìch le
504agus an seòrsaapi_error. Is e502toradh falamh. Làimhseachadh mearachd
- Briseadh
Gabhaidh modailean open-weight hosted ris an input a ghabhas am modail ainmichte. Thèid dealbh a chuirear gu id teacsa a-mhàin a fhreagairt le
400agus<id> does not accept image input. Thèidresponse_formatair id gun output structaraichte a fhreagairt le400. BheirGET /v1/modelscunntas aircapabilities.vision,response_formatagusjson_schemaairson gach id. Dealbhan agus faidhlichean - Chàirich
Bidh teacsa reusanachaidh aig freagairtean gun streaming:
reasoning_contentair teachdaireachd/v1/chat/completions, agus blocthinkingron teacsa air/v1/messages. Oidhirp reusanachaidh - Air atharrachadh
Tha prìsean ùra aig modailean open-weight hosted, bho $0.50 gach 1M input tokens agus $2.00 gach 1M output tokens. Modailean & prìsean
- Air atharrachadh
Tha aon id aig gach modail open-weight hosted, dusan id gu h-iomlan. Modailean & prìsean
- Ùr
Output structaraichte air
shannon-3,shannon-3-pro,shannon-3.1agusshannon-3.1-pro. BheirGET /v1/modelscunntas aircapabilities.json_schema: truedhaibh. Toraidhean structarail - Ùr
Leughaidh
/v1/responsestext.format(json_objectnojson_schema) airson output structaraichte. Responses API - Chàirich
Tillidh
/v1/responsesreusanachadh nam modailean Shannon: nì às-chuirreasoningron nìmessage, agus na tachartasan streamresponse.reasoning_summary_text.deltaagusresponse.reasoning_summary_text.done. Responses API - Chàirich
Is e an id foillsichte an raon
modelann am freagairt air gach endpoint. Thamodelaguscreated_atann an nì Responses. - Leasaichte
Bheir
GET /v1/modelscunntas air uinneag cho-theacsa gach modail. Modailean & prìsean
- Ùr
Freagraidh modailean open-weight hosted air
/v1/messagesagus/v1/responsesa bharrachd air/v1/chat/completions, leis an system prompt agus gairmean inneil agad. Gabhaidh/v1/messagesrithinking, agus thareasoning_effortna raon iarrtais. Modailean & prìsean - Leasaichte
Leanaidh bodhaigean mearachd air
/v1cruthan nan SDK: nìerrorletypeagusmessageair na h-endpoints ann am fòrmat OpenAI, agus an aon nì am broinn{"type": "error"}air/v1/messages. Làimhseachadh mearachd - Ùr
Keep-alive air streams fosgailte gach 15 diogan: loidhne bheachd
: pingair/v1/chat/completions,event: pingair/v1/messages. Sruthadh - Air atharrachadh
Tòisichidh ids ghairmean inneil le
call_air/v1/chat/completionsagus/v1/responses, agus letoolu_air/v1/messages. Call gnìomh - Briseadh
/v1/responses: is efalsebun-roghainnstream. Responses API - Ùr
Thèid
max_completion_tokensaontachadh mar ainm eile airmax_tokensair/v1/chat/completions. Chat Completions - Chàirich
Bidh an t-array
outputaig an tachartasresponse.completedaig stream Responses. Responses API - Ùr
Tha
display_name,context_window,max_output_tokens,pricing,capabilitiesagusendpointsann an inntrigidheanGET /v1/models. Modailean & prìsean - Ùr
Tha
x-request-idaig gach freagairt, agus thèid luach a chuireas tu a thilleadh. Faodaidh bodhaigean iarrtais a bhith suas gu 32 MiB. - Ùr
Faodar iuchair a chur à bith gun iuchair ùr a thoirt seachad. Tha an loga usage air a roinn ann an duilleagan.
- Ùr
Dealbhan is sgrìobhainnean ann an iarrtasan: pàirtean
image_urlair/v1/chat/completions, blocaicheanimage,documentagusfileair/v1/messages, pàirteaninput_imageair/v1/responses. Dealbhan agus faidhlichean - Ùr
Modail ùr
shannon-3-pro. Modailean & prìsean
- Ùr
Modail ùr
shannon-3. Modailean & prìsean - Ùr
Bidh streams air
/v1/chat/completionsa’ giùlan an reusanachaidh mardelta.reasoning_content. Oidhirp reusanachaidh
- Air atharrachadh
Tha
max_tokensair a chumail eadar 1 agus 65,536. Thèid luach taobh a-muigh na rèimse sin a thoirt chun na crìche as fhaisge, chan eil e air a dhiùltadh. Chat Completions
- Ùr
Thèid
shannon-coder-1a chunntadh ann an gairmean gach plana air/v1/chat/completionsagus/v1/messages. Nuair a thèid gairmean uinneige a chleachdadh, is e429am freagairt leis an teachdaireachdShannon Coder call quota reached. Innealan còdachaidh CLI - Ùr
Thèid còmhradh nas motha na an uinneag cho-theacsa a fhreagairt le
400, an seòrsainvalid_request_erroragus an còdcontext_length_exceeded. Thig mearachd am broinn stream mar thachartas mearachd, chan ann mar theacsa sa fhreagairt. Innealan còdachaidh CLI
- Ùr
Na h-endpoints
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesagusGET /v1/models. Is iad sin na h-endpoints a ghairmeas SDKan OpenAI agus Anthropic, Claude Code agus Codex CLI. Ro-shealladh - Ùr
Gairmean inneil le
toolsair/v1/chat/completionsagus/v1/messages, output structaraichte leresponse_format, agussystemmar sreang no mar bhlocaichean teacsa air/v1/messages. Call gnìomh
- Ùr
Ids modail
shannon-1.6-pro,shannon-2-lite,shannon-2-proagusshannon-coder-1, ri taobhshannon-1.6-lite. Modailean & prìsean
- Ùr
A’ chiad sgaoileadh dhen API: còmhradh san fhòrmat OpenAI agus san fhòrmat Anthropic, agus endpoint Responses, gach fear air a ghairm le iuchair API a thòisicheas le
sk-. Dearbhadh