Дневник на промени
Последни ажурирања и подобрувања на Shannon API.
Оваа страница ги наведува промените што можете да ги забележите како корисник на API-то: нови endpoint-и, полиња и модели, променето однесување и поправки. Најновите записи се први. Секој запис го носи датумот на промената.
Запис означен со Breaking може да го промени резултатот на барање што претходно работело. API-то има една верзија, /v1, па промените се наведени по датум, а не по број на верзија.
- Ново
Барање со
web_search: trueги именува своите извори:sourcesна/v1/chat/completionsи/v1/messagesги наведува резултатите што му биле дадени на моделот, а на/v1/chat/completionsannotationsозначува каде одговорот го цитира секој од нив. Вградено веб пребарување
- Ново
web_search: trueна/v1/chat/completionsи/v1/messagesизвршува веб пребарување пред моделот да одговори и му ги дава резултатите како нумерирани извори. Барање што нашло резултати користи едно пребарување од вашиот дневен лимит. Ако нема останато, на барањето се одговара без пребарување. Вградено веб пребарување
- Поправено
Streaming прекинат на страната на серверот се наплатува за употребата пријавена до таа точка. Остатокот од резервацијата се враќа на вашето салдо.
- Поправено
shannon-coder-1одговара на/v1/responsesкако и на другите два endpoint-и. CLI алатки за програмирање - Поправено
Ротиран API клуч веднаш престанува да работи.
- Ново
POST /v1/tokenizeиPOST /v1/messages/count_tokens: бесплатно броење токени за хостираните open-weight модели. Броење токени - Ново
Prompt caching на хостираните open-weight модели. Кешираниот влез се наплатува по 25% од цената на влезот и се пријавува во
usageна сите три endpoint-и:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensиcache_read_input_tokens.GET /v1/modelsпријавуваpricing.cached_input_per_million_usdиcapabilities.prompt_cachingза овие модели. Кеширање на промптови - Поправено
Хостирани open-weight модели: принуден
tool_choice(requiredили именувана функција) дава повик на алатка. Повик на функции - Поправено
Хостираните open-weight модели прифаќаат порака
systemшто не е првата порака во разговорот.
- Ново
API-то е достапно како Tor onion сервис и на I2P адреса. Одговорите на
api.shannon-ai.comги носат двете адреси во заглавијатаOnion-LocationиX-I2P-Location. Шифрирани, Tor и I2P ендпоинти
- Ново
Нови модели
shannon-3.1иshannon-3.1-pro, наведени одGET /v1/models. Модели и цени - Променето
Барање со streaming чиј клиент ќе се исклучи се извршува до крај и се брои. Претходно одговорот запираше при исклучувањето.
- Поправено
Барањата до
/v1/responsesсе појавуваат во дневникот на употреба.
- Ново
Хостираните open-weight модели ги применуваат полињата за семплирање:
temperature,top_p,seed,stopиmax_tokensна/v1/chat/completions;temperature,top_pиstop_sequencesна/v1/messages;temperature,top_pиmax_output_tokensна/v1/responses. Chat Completions - Ново
Дневникот на употреба прикажува трошок во USD за секој повик и како збир.
- Ломечко
На вредност
modelшто не е објавен ид се одговара со400, типотinvalid_request_errorи поракатаunknown model: <id>на сите три endpoint-и. Претходно на такво барање одговарашеshannon-1.6-lite. Модели и цени - Ломечко
/v1прима само API клуч. Колачето од најава на веб-страницата таму не се чита. Автентикација - Променето
Flood protection: 120 барања во минута по сметка на трите endpoint-и за генерирање. Ограничувања и салдо
- Подобрено
Кога моделот не може да одговори, грешката ја носи фиксната порака
The model backend failed to answer. Please retry.На проверка на салдо што не може да се направи се одговара со503и типотapi_error. Ракување со грешки - Поправено
Барање без streaming што не успее ја враќа својата резервација на вашето салдо.
- Ново
GET /v1/modelsпријавуваcapabilities.reasoning_effortза секој модел. Напор на reasoning - Подобрено
Хостирани open-weight модели: барање без streaming што не добива одговор завршува со
504и типотapi_error. Празен резултат е502. Ракување со грешки
- Ломечко
Хостираните open-weight модели го примаат влезот што го прима именуваниот модел. На слика испратена до ид само за текст се одговара со
400и<id> does not accept image input. Наresponse_formatна ид без структуриран излез се одговара со400.GET /v1/modelsпријавуваcapabilities.vision,response_formatиjson_schemaза секој ид. Слики и датотеки - Поправено
Одговорите без streaming го носат текстот на reasoning-от:
reasoning_contentна пораката на/v1/chat/completionsи блокthinkingпред текстот на/v1/messages. Напор на reasoning - Променето
Хостираните open-weight модели имаат нови цени, од $0.50 за 1M влезни токени и $2.00 за 1M излезни токени. Модели и цени
- Променето
Хостираните open-weight модели имаат по еден ид на модел, вкупно дванаесет ид-а. Модели и цени
- Ново
Структуриран излез на
shannon-3,shannon-3-pro,shannon-3.1иshannon-3.1-pro.GET /v1/modelsпријавуваcapabilities.json_schema: trueза нив. Структурирани излези - Ново
/v1/responsesго читаtext.format(json_objectилиjson_schema) за структуриран излез. Responses API - Поправено
/v1/responsesго враќа reasoning-от на Shannon моделите: излезна ставкаreasoningпред ставкатаmessageи streaming настанитеresponse.reasoning_summary_text.deltaиresponse.reasoning_summary_text.done. Responses API - Поправено
Полето
modelна одговорот е објавениот ид на секој endpoint. Објектот Responses ги носиmodelиcreated_at. - Подобрено
GET /v1/modelsго пријавува контекстниот прозорец на секој модел. Модели и цени
- Ново
Хостираните open-weight модели одговараат и на
/v1/messagesи/v1/responses, како и на/v1/chat/completions, со вашиот system prompt и повици на алатки./v1/messagesпримаthinking, аreasoning_effortе поле на барањето. Модели и цени - Подобрено
Телата на грешки на
/v1ги следат облиците на SDK-ата: објектerrorсоtypeиmessageна endpoint-ите во OpenAI формат, и истиот објект во{"type": "error"}на/v1/messages. Ракување со грешки - Ново
Keep-alive на отворени streaming-и на секои 15 секунди: коментар ред
: pingна/v1/chat/completions,event: pingна/v1/messages. Стриминг - Променето
ID-а на повици на алатки започнуваат со
call_на/v1/chat/completionsи/v1/responses, а соtoolu_на/v1/messages. Повик на функции - Ломечко
/v1/responses:streamе стандардноfalse. Responses API - Ново
max_completion_tokensсе прифаќа како друго име заmax_tokensна/v1/chat/completions. Chat Completions - Поправено
Настанот
response.completedна Responses streaming го носи низатаoutput. Responses API - Ново
Записите на
GET /v1/modelsги носатdisplay_name,context_window,max_output_tokens,pricing,capabilitiesиendpoints. Модели и цени - Ново
Секој одговор го носи
x-request-id, а вредноста што ја испраќате се враќа. Телата на барања можат да бидат до 32 MiB. - Ново
Клучот може да се отповика без да се издаде нов. Дневникот на употреба е по страници.
- Ново
Слики и документи во барања: делови
image_urlна/v1/chat/completions, блоковиimage,documentиfileна/v1/messages, деловиinput_imageна/v1/responses. Слики и датотеки - Ново
Нов модел
shannon-3-pro. Модели и цени
- Ново
Нов модел
shannon-3. Модели и цени - Ново
Streaming-ите на
/v1/chat/completionsго носат reasoning-от какоdelta.reasoning_content. Напор на reasoning
- Променето
max_tokensсе држи во опсегот од 1 до 65,536. Вредност надвор од тој опсег се доведува до најблискиот крај, а не се одбива. Chat Completions
- Ново
shannon-coder-1се брои во повици по план на/v1/chat/completionsи/v1/messages. Кога повиците на еден прозорец се искористени, одговорот е429со поракаShannon Coder call quota reached. CLI алатки за програмирање - Ново
На разговор поголем од контекстниот прозорец се одговара со
400, типотinvalid_request_errorи кодотcontext_length_exceeded. Грешка во streaming пристигнува како настан за грешка, а не како текст во одговорот. CLI алатки за програмирање
- Ново
Endpoint-ите
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesиGET /v1/models. Тоа се endpoint-ите што ги повикуваат OpenAI и Anthropic SDK-ата, Claude Code и Codex CLI. Преглед - Ново
Повици на алатки со
toolsна/v1/chat/completionsи/v1/messages, структуриран излез соresponse_formatиsystemкако стринг или како текстуални блокови на/v1/messages. Повик на функции
- Ново
ID-а на модели
shannon-1.6-pro,shannon-2-lite,shannon-2-proиshannon-coder-1, покрајshannon-1.6-lite. Модели и цени
- Ново
Прво издание на API-то: разговор во форматот на OpenAI и во форматот на Anthropic, и Responses endpoint, секој повикуван со API клуч што започнува со
sk-. Автентикација