Журнал изменений

Запрос с 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: бесплатный подсчет токенов для размещенных моделей с открытыми весами. Подсчет токенов

Кэширование промптов на размещенных моделях с открытыми весами. Кэшированный ввод тарифицируется по 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 для этих моделей. Кэширование запросов

Размещенные модели с открытыми весами: принудительный tool_choice (required или именованная функция) дает вызов инструмента. Вызов функций

Размещенные модели с открытыми весами принимают сообщение system, которое не является первым сообщением разговора.

API доступен как onion-сервис Tor и по адресу I2P. Ответы api.shannon-ai.com содержат оба адреса в заголовках Onion-Location и X-I2P-Location. Зашифрованные эндпоинты, Tor и I2P

Новые модели shannon-3.1 и shannon-3.1-pro, перечисляемые GET /v1/models. Модели и цены

Потоковый запрос, клиент которого отключился, выполняется до конца и засчитывается. Раньше ответ прекращался при отключении.

Запросы к /v1/responses отображаются в журнале использования.

Размещенные модели с открытыми весами применяют поля сэмплирования: 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-ключ. Cookie входа на сайт там не читается. Аутентификация

Защита от флуда: 120 запросов в минуту на аккаунт на трех эндпоинтах генерации. Лимиты и баланс

Когда модель не может ответить, ошибка содержит фиксированное сообщение The model backend failed to answer. Please retry. Если проверку баланса выполнить нельзя, отвечают 503 и типом api_error. Обработка ошибок

Непотоковый запрос, завершившийся ошибкой, возвращает свой резерв на ваш баланс.

GET /v1/models сообщает capabilities.reasoning_effort для каждой модели. Усилие рассуждения

Размещенные модели с открытыми весами: непотоковый запрос, не получивший ответа, завершается 504 и типом api_error. Пустой результат — 502. Обработка ошибок

Размещенные модели с открытыми весами принимают тот ввод, который принимает названная модель. Изображение, отправленное на 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. Усилие рассуждения

У размещенных моделей с открытыми весами новые цены, от $0.50 за 1M входных токенов и $2.00 за 1M выходных токенов. Модели и цены

У размещенных моделей с открытыми весами один 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 сообщает контекстное окно каждой модели. Модели и цены

Размещенные модели с открытыми весами отвечают и на /v1/messages, и на /v1/responses, а не только на /v1/chat/completions, с вашим системным промптом и вызовами инструментов. /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-. Аутентификация