Журнал змін

Запит з web_search: true називає свої джерела: sources на /v1/chat/completions і /v1/messages перелічує результати, які отримала модель, а annotations на /v1/chat/completions позначає, де відповідь цитує кожне з них. Вбудований веб‑пошук

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 моделей. Підрахунок токенів

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

Хостовані open-weight моделі: примусовий tool_choice (required або названа функція) дає виклик інструмента. Виклик функцій

Хостовані open-weight моделі приймають повідомлення 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 з'являються в журналі використання.

Хостовані 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-ключ. Cookie входу на сайті там не читається. Аутентифікація

Захист від флуду: 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, із вашим системним промптом і викликами інструментів. /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-. Аутентифікація