Возможности

К каждой модели обращаются через те же три эндпоинта с тем же ключом. Две таблицы показывают, чем модели отличаются. Прочерк означает, что модель отвечает без этой возможности.

Модели Shannon

Размещенные модели с открытыми весами

Id размещенной модели — это ее имя и вариант, соединенные дефисом, например DeepSeek-V4-Pro-0813-3BIT-REAP.

Что означает каждый столбец

• Инструменты. Вы описываете функции в tools, модель отвечает вызовами, которые хочет выполнить, а ваш код их запускает. Все модели принимают инструменты. Принудительный tool_choice применяют размещенные модели с открытыми весами. Вызов функций
• Ввод изображений. Модель читает изображения, отправленные в сообщении пользователя, как 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 — флаги записей размещенных моделей с открытыми весами. Запись Shannon сообщает о JSON-выводе одним json_schema, который означает оба JSON-режима.
• vision равно true для shannon-2-lite и shannon-2-pro: они читают изображения в запросах, которые также отправляют tools или response_format.

Вне строки модели

Размещенная модель с открытыми весами отклоняет изображение или JSON-режим, которых нет в ее строке. Отказ происходит до списания чего-либо с вашего баланса:

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