Към съдържанието
Дневник на промените

Дневник на промените

Последни обновления и подобрения на Shannon API.

Тази страница изброява промените, които можете да наблюдавате като потребител на API: нови ендпоинти, полета и модели, променено поведение и поправки. Най-новите записи са първи. Всеки запис носи датата, на която е направена промяната.

Запис, отбелязан като Променящи, може да промени резултата от заявка, която преди е работела. API има една версия, /v1, затова промените са изброени по дата, а не по номер на версия.

  • Ново

    Заявка с web_search: true назовава източниците си: sources на /v1/chat/completions и /v1/messages изброява резултатите, дадени на модела, а на /v1/chat/completions annotations отбелязва къде отговорът цитира всеки от тях. Вградено уеб търсене

  • Ново

    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. Модели и цени

  • Променено

    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-. Удостоверяване