Можливості

До кожної моделі звертаються через ті самі три ендпоінти з тим самим ключем. Дві таблиці показують, де моделі відрізняються. Риска означає, що модель відповідає без цієї можливості.

Моделі Shannon

Хостовані open-weight моделі

Id хостованої моделі — це її назва та варіант, з'єднані дефісом, наприклад DeepSeek-V4-Pro-0813-3BIT-REAP.

Що означає кожен стовпець

• Інструменти. Ви описуєте функції в tools, модель відповідає викликами, які хоче зробити, а ваш код їх виконує. Кожна модель приймає інструменти. Примусовий tool_choice застосовують хостовані open-weight моделі. Виклик функцій
• Вхідні зображення. Модель читає зображення, надіслані у повідомленні користувача, як data URL або як адресу. shannon-2-lite і shannon-2-pro читають зображення в запитах, що також надсилають tools або response_format. Сімейство Shannon 3 читає також документи. Зображення та файли
• Міркування. Відповідь може містити текст міркувань моделі поряд із відповіддю, в окремому полі. Зусилля міркування
• Зусилля міркування. Поле запиту задає, наскільки глибоко модель міркує: off, low, medium або high. Моделі Shannon самі визначають глибину. Зусилля міркування
• JSON-об'єкт. З response_format: {"type": "json_object"} відповідь — це JSON без заданої форми. На /v1/chat/completions і /v1/responses. Структуровані відповіді
• JSON-схема. З response_format типу json_schema відповідь відповідає схемі, яку ви надсилаєте. На /v1/chat/completions і /v1/responses. Структуровані відповіді
• Кешування запитів. Промпт, що починається так само, як нещодавній на тій самій моделі, читається з кешу, а кешована частина тарифікується за 25% від ціни входу. Поле запиту для цього не потрібне. Кешування запитів
• Веб-пошук. З web_search: true API шукає в вебі та передає результати моделі перед відповіддю. На /v1/chat/completions і /v1/messages. Це поле запиту, і прапорця для нього в GET /v1/models немає. Вбудований веб‑пошук
• Стрімінг. З stream: true відповідь надходить як server-sent events, поки модель пише. Кожна модель підтримує стрімінг на всіх трьох ендпоінтах. Стримінг

Ті самі факти з GET /v1/models

GET https://api.shannon-ai.com/v1/models

GET /v1/models перелічує кожну модель з об'єктом capabilities, тож програма може читати ці факти замість цієї сторінки. Ендпоінту ключ не потрібен.

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.shannon-ai.com/v1")

for model in client.models.list():
    print(model.id, getattr(model, "capabilities", None))

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "YOUR_API_KEY", baseURL: "https://api.shannon-ai.com/v1" });

for await (const model of client.models.list()) {
  console.log(model.id, model.capabilities);
}

curl https://api.shannon-ai.com/v1/models

id і capabilities двох записів у data:

[
  {
    "id": "shannon-3",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": false,
      "streaming": true,
      "json_schema": true
    }
  },
  {
    "id": "Kimi-K3-3BIT-REAP",
    "capabilities": {
      "tools": true,
      "vision": true,
      "reasoning": true,
      "reasoning_effort": true,
      "streaming": true,
      "response_format": true,
      "json_schema": true,
      "prompt_caching": true
    }
  }
]

• response_format і prompt_caching — це прапорці записів хостованих open-weight моделей. Запис Shannon повідомляє про JSON-вивід лише через json_schema, що означає обидва режими JSON.
• vision дорівнює true для shannon-2-lite і shannon-2-pro: вони читають зображення в запитах, що також надсилають tools або response_format.

Поза рядком моделі

Хостована open-weight модель відхиляє зображення або режим JSON, що виходять за межі її рядка. Відмова настає раніше, ніж щось списується з вашого балансу:

Модель Shannon відповідає на такий запит зі статусом 200: можливість поза її рядком не бере участі у відповіді. Обробка помилок