Дневник на промените
Последни обновления и подобрения на Shannon API.
Тази страница изброява промените, които можете да наблюдавате като потребител на API: нови ендпоинти, полета и модели, променено поведение и поправки. Най-новите записи са първи. Всеки запис носи датата, на която е направена промяната.
Запис, отбелязан като Променящи, може да промени резултата от заявка, която преди е работела. API има една версия, /v1, затова промените са изброени по дата, а не по номер на версия.
- Ново
Заявка с
web_search: trueназовава източниците си:sourcesна/v1/chat/completionsи/v1/messagesизброява резултатите, дадени на модела, а на/v1/chat/completionsannotationsотбелязва къде отговорът цитира всеки от тях. Вградено уеб търсене
- Ново
web_search: trueна/v1/chat/completionsи/v1/messagesизпълнява уеб търсене, преди моделът да отговори, и му дава резултатите като номерирани източници. Заявка, която е намерила резултати, използва едно търсене от дневния ви лимит. Когато не е останало, заявката получава отговор без търсене. Вградено уеб търсене
- Поправено
Стрийм, прекъснат от страна на сървъра, се таксува за usage, отчетен до този момент. Остатъкът от заделената сума се връща в баланса ви.
- Поправено
shannon-coder-1отговаря на/v1/responsesтака, както на другите два ендпоинта. CLI инструменти за програмиране - Поправено
Сменен API ключ спира да работи веднага.
- Ново
POST /v1/tokenizeиPOST /v1/messages/count_tokens: безплатно броене на токени за хостваните open-weight модели. Броене на токени - Ново
Кеширане на prompt-и при хостваните open-weight модели. Кешираният вход се таксува на 25% от цената на входа и се отчита в
usageна трите ендпоинта: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за тези модели. Кеширане на prompt-и - Поправено
Хостваните 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. Модели и цени - Променено
Заявка със стрийминг, чийто клиент прекъсне връзката, се изпълнява докрай и се отчита. Преди отговорът спираше при прекъсването.
- Поправено
Заявките към
/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, която не е публикуван id, получава отговор400, типinvalid_request_errorи съобщениеunknown model: <id>на трите ендпоинта. Преди такава заявка получаваше отговор отshannon-1.6-lite. Модели и цени - Променящи
/v1приема само API ключ. Бисквитка за вход на уебсайта не се чете там. Удостоверяване - Променено
Защита от наводняване: 120 заявки в минута на акаунт на трите ендпоинта за генериране. Ограничения и баланс
- Подобрено
Когато моделът не може да отговори, грешката носи фиксираното съобщение
The model backend failed to answer. Please retry.Проверка на баланса, която не може да бъде направена, получава отговор503и типapi_error. Обработка на грешки - Поправено
Заявка без стрийминг, която пропадне, връща заделената сума в баланса ви.
- Ново
GET /v1/modelsотчитаcapabilities.reasoning_effortза всеки модел. Усилие за разсъждение - Подобрено
Хоствани open-weight модели: заявка без стрийминг, която не получи отговор, завършва с
504и типapi_error. Празен резултат е502. Обработка на грешки
- Променящи
Хостваните open-weight модели приемат входа, който приема посоченият модел. Изображение, изпратено към id само за текст, получава отговор
400и<id> does not accept image input.response_formatкъм id без структуриран изход получава отговор400.GET /v1/modelsотчитаcapabilities.vision,response_formatиjson_schemaза всеки id. Изображения и файлове - Поправено
Отговорите без стрийминг носят текста на разсъжденията:
reasoning_contentв съобщението на/v1/chat/completionsи блокthinkingпреди текста на/v1/messages. Усилие за разсъждение - Променено
Хостваните open-weight модели имат нови цени, от $0.50 на 1M входни токена и $2.00 на 1M изходни токена. Модели и цени
- Променено
Хостваните open-weight модели имат по един id на модел, общо дванадесет id-та. Модели и цени
- Ново
Структуриран изход при
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връща разсъжденията на моделите на Shannon: изходен елементreasoningпреди елементаmessageи събитията на стриймаresponse.reasoning_summary_text.deltaиresponse.reasoning_summary_text.done. Responses API - Поправено
Полето
modelна отговора е публикуваният id на всеки ендпоинт. Обект Responses носиmodelиcreated_at. - Подобрено
GET /v1/modelsотчита контекстния прозорец на всеки модел. Модели и цени
- Ново
Хостваните open-weight модели отговарят на
/v1/messagesи/v1/responses, както и на/v1/chat/completions, с вашия системен prompt и извиквания на инструменти./v1/messagesприемаthinking, аreasoning_effortе поле на заявката. Модели и цени - Подобрено
Телата на грешките на
/v1следват формите на SDK: обектerrorсtypeиmessageна ендпоинтите във формат OpenAI и същият обект вътре в{"type": "error"}на/v1/messages. Обработка на грешки - Ново
Keep-alive на отворените стриймове на всеки 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 носи масива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. Модели и цени - Ново
Стриймовете на
/v1/chat/completionsносят разсъжденията катоdelta.reasoning_content. Усилие за разсъждение
- Променено
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. Грешка в рамките на стрийм пристига като събитие за грешка, а не като текст в отговора. CLI инструменти за програмиране
- Ново
Ендпоинтите
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesиGET /v1/models. Това са ендпоинтите, които извикват SDK на OpenAI и Anthropic, 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, всеки извикван с API ключ, който започва със
sk-. Удостоверяване