Veranderingslog
Onlangse opdaterings en verbeterings aan die Shannon API.
Hierdie bladsy lys die veranderinge wat jy as roeper van die API kan waarneem: nuwe eindpunte, velde en modelle, veranderde gedrag en regstellings. Die nuutste inskrywings kom eerste. Elke inskrywing dra die datum waarop die verandering gemaak is.
'n Inskrywing gemerk Brekend kan die resultaat verander van 'n versoek wat voorheen gewerk het. Die API het een weergawe, /v1, so veranderinge word volgens datum gelys en nie volgens weergawenommer nie.
- Nuut
'n Versoek met
web_search: truenoem sy bronne:sourcesop/v1/chat/completionsen/v1/messageslys die resultate wat aan die model gegee is, en op/v1/chat/completionsmerkannotationswaar die antwoord elkeen aanhaal. Websoektog
- Nuut
web_search: trueop/v1/chat/completionsen/v1/messagesvoer 'n websoektog uit voordat die model antwoord en gee dit die resultate as genommerde bronne. 'n Versoek wat resultate gevind het, gebruik een soektog van jou daaglikse toelaat. As daar geen oor is nie, word die versoek sonder soektog beantwoord. Websoektog
- Reggestel
'n Stroom wat aan die bedienerkant afgesny word, word gefaktureer vir die gebruik wat tot op daardie punt gerapporteer is. Die res van die reservering keer terug na jou balans.
- Reggestel
shannon-coder-1antwoord op/v1/responsessoos op die ander twee eindpunte. CLI-koderingsgereedskap - Reggestel
'n Geroteerde API-sleutel hou dadelik op werk.
- Nuut
POST /v1/tokenizeenPOST /v1/messages/count_tokens: gratis tokentellings vir die gehuisveste oopgewig-modelle. Tokens tel - Nuut
Prompt caching op die gehuisveste oopgewig-modelle. Gekasde inset word teen 25% van die insetprys gefaktureer en in
usageop al drie eindpunte gerapporteer:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensencache_read_input_tokens.GET /v1/modelsrapporteerpricing.cached_input_per_million_usdencapabilities.prompt_cachingvir hierdie modelle. Prompt-kassing - Reggestel
Gehuisveste oopgewig-modelle: 'n afgedwonge
tool_choice(requiredof 'n genoemde funksie) lewer 'n gereedskapoproep. Funksie-oproepe - Reggestel
Gehuisveste oopgewig-modelle aanvaar 'n
system-boodskap wat nie die eerste boodskap van die gesprek is nie.
- Nuut
Die API is bereikbaar as 'n Tor-onion-diens en by 'n I2P-adres. Antwoorde van
api.shannon-ai.comdra die twee adresse in die headersOnion-LocationenX-I2P-Location. Geënkripteerde, Tor- en I2P-eindpunte
- Nuut
Nuwe modelle
shannon-3.1enshannon-3.1-pro, gelys deurGET /v1/models. Modelle en pryse - Verander
'n Gestroomde versoek waarvan die kliënt ontkoppel, loop tot sy einde en word getel. Voorheen het die antwoord by die ontkoppeling gestop.
- Reggestel
Versoeke aan
/v1/responsesverskyn in die gebruikslog.
- Nuut
Gehuisveste oopgewig-modelle pas die steekproefvelde toe:
temperature,top_p,seed,stopenmax_tokensop/v1/chat/completions;temperature,top_penstop_sequencesop/v1/messages;temperature,top_penmax_output_tokensop/v1/responses. Chat Completions - Nuut
Die gebruikslog wys 'n koste in USD vir elke oproep en as 'n totaal.
- Brekend
'n
model-waarde wat nie 'n gepubliseerde id is nie, word met400, die tipeinvalid_request_erroren die boodskapunknown model: <id>beantwoord op al drie eindpunte. Voorheen is so 'n versoek deurshannon-1.6-litebeantwoord. Modelle en pryse - Brekend
/v1neem slegs 'n API-sleutel. 'n Aanmeldkoekie van die webwerf word daar nie gelees nie. Verifikasie - Verander
Vloedbeskerming: 120 versoeke per minuut per rekening op die drie generasie-eindpunte. Perke en balans
- Verbeter
Wanneer die model nie kan antwoord nie, dra die fout die vaste boodskap
The model backend failed to answer. Please retry.'n Balanskontrole wat nie gedoen kan word nie, word met503en die tipeapi_errorbeantwoord. Fouthantering - Reggestel
'n Ongestroomde versoek wat misluk, gee sy reservering terug aan jou balans.
- Nuut
GET /v1/modelsrapporteercapabilities.reasoning_effortvir elke model. Redeneringspoging - Verbeter
Gehuisveste oopgewig-modelle: 'n ongestroomde versoek wat geen antwoord kry nie, eindig met
504en die tipeapi_error. 'n Leë resultaat is502. Fouthantering
- Brekend
Gehuisveste oopgewig-modelle neem die inset wat die genoemde model neem. 'n Beeld wat na 'n id net vir teks gestuur word, word met
400en<id> does not accept image inputbeantwoord.response_formatop 'n id sonder gestruktureerde uitvoer word met400beantwoord.GET /v1/modelsrapporteercapabilities.vision,response_formatenjson_schemavir elke id. Beelde en lêers - Reggestel
Ongestroomde antwoorde dra die redeneringsteks:
reasoning_contentop die boodskap van/v1/chat/completions, en 'nthinking-blok voor die teks op/v1/messages. Redeneringspoging - Verander
Gehuisveste oopgewig-modelle het nuwe pryse, vanaf $0.50 per 1M insettokens en $2.00 per 1M uitvoertokens. Modelle en pryse
- Verander
Gehuisveste oopgewig-modelle het een id per model, twaalf id's in totaal. Modelle en pryse
- Nuut
Gestruktureerde uitvoer op
shannon-3,shannon-3-pro,shannon-3.1enshannon-3.1-pro.GET /v1/modelsrapporteercapabilities.json_schema: truevir hulle. Gestruktureerde uitvoer - Nuut
/v1/responsesleestext.format(json_objectofjson_schema) vir gestruktureerde uitvoer. Responses API - Reggestel
/v1/responsesgee die redenering van die Shannon-modelle terug: 'nreasoning-uitvoeritem voor diemessage-item, en die stroomgebeurtenisseresponse.reasoning_summary_text.deltaenresponse.reasoning_summary_text.done. Responses API - Reggestel
Die
model-veld van 'n antwoord is die gepubliseerde id op elke eindpunt. 'n Responses-objek dramodelencreated_at. - Verbeter
GET /v1/modelsrapporteer die konteksvenster van elke model. Modelle en pryse
- Nuut
Gehuisveste oopgewig-modelle antwoord ook op
/v1/messagesen/v1/responsesen nie net op/v1/chat/completionsnie, met jou stelselprompt en gereedskapoproepe./v1/messagesneemthinking, enreasoning_effortis 'n versoekveld. Modelle en pryse - Verbeter
Foutliggame op
/v1volg die SDK-vorme: 'nerror-objek mettypeenmessageop die eindpunte in OpenAI-formaat, en dieselfde objek binne{"type": "error"}op/v1/messages. Fouthantering - Nuut
Keep-alive op oop strome elke 15 sekondes: 'n
: ping-kommentaarreël op/v1/chat/completions, 'nevent: pingop/v1/messages. Stroming - Verander
Gereedskapoproep-id's begin met
call_op/v1/chat/completionsen/v1/responses, en mettoolu_op/v1/messages. Funksie-oproepe - Brekend
/v1/responses:streamis by verstekfalse. Responses API - Nuut
max_completion_tokensword aanvaar as 'n ander naam virmax_tokensop/v1/chat/completions. Chat Completions - Reggestel
Die
response.completed-gebeurtenis van 'n Responses-stroom dra dieoutput-skikking. Responses API - Nuut
GET /v1/models-inskrywings dradisplay_name,context_window,max_output_tokens,pricing,capabilitiesenendpoints. Modelle en pryse - Nuut
Elke antwoord dra
x-request-id, en 'n waarde wat jy stuur, word teruggegee. Versoekliggame kan tot 32 MiB wees. - Nuut
'n Sleutel kan herroep word sonder dat 'n nuwe een uitgereik word. Die gebruikslog is in bladsye verdeel.
- Nuut
Beelde en dokumente in versoeke:
image_url-dele op/v1/chat/completions,image-,document- enfile-blokke op/v1/messages,input_image-dele op/v1/responses. Beelde en lêers - Nuut
Nuwe model
shannon-3-pro. Modelle en pryse
- Nuut
Nuwe model
shannon-3. Modelle en pryse - Nuut
Strome op
/v1/chat/completionsdra die redenering asdelta.reasoning_content. Redeneringspoging
- Verander
max_tokensword binne 1 tot 65,536 gehou. 'n Waarde buite daardie reeks word na die naaste punt gebring, nie geweier nie. Chat Completions
- Nuut
shannon-coder-1word in oproepe per plan getel op/v1/chat/completionsen/v1/messages. Wanneer die oproepe van 'n venster opgebruik is, is die antwoord429met die boodskapShannon Coder call quota reached. CLI-koderingsgereedskap - Nuut
'n Gesprek groter as die konteksvenster word met
400beantwoord, die tipeinvalid_request_erroren die kodecontext_length_exceeded. 'n Fout binne 'n stroom kom aan as 'n foutgebeurtenis, nie as teks in die antwoord nie. CLI-koderingsgereedskap
- Nuut
Die
/v1-eindpunte:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesenGET /v1/models. Dit is die eindpunte wat die OpenAI- en Anthropic-SDK's, Claude Code en Codex CLI roep. Oorsig - Nuut
Gereedskapoproepe met
toolsop/v1/chat/completionsen/v1/messages, gestruktureerde uitvoer metresponse_format, ensystemas 'n string of as teksblokke op/v1/messages. Funksie-oproepe
- Nuut
Model-id's
shannon-1.6-pro,shannon-2-lite,shannon-2-proenshannon-coder-1, langsshannon-1.6-lite. Modelle en pryse
- Nuut
Eerste vrystelling van die API: klets in die OpenAI-formaat en in die Anthropic-formaat, en 'n Responses-eindpunt, elk geroep met 'n API-sleutel wat met
sk-begin. Verifikasie