Към съдържанието
Възможности

Възможности

Какво може всеки модел през API, модел по модел: инструменти, вход с изображения, разсъждение, JSON изход, кеширане на prompt-и, уеб търсене и стрийминг.

До всеки модел се стига през едни и същи три ендпоинта със същия ключ. Двете таблици показват къде моделите се различават. Тире означава, че моделът отговаря без тази възможност.

Модели на Shannon

Модел ИнструментиИзображенияРазсъждениеУсилиеJSON обектJSON схемаКешТърсенеСтрийминг
shannon-1.6-lite ДаДа——ДаДа—ДаДа
shannon-1.6-pro ДаДаДа—ДаДа—ДаДа
shannon-2-lite Да—Да—ДаДа—ДаДа
shannon-2-pro Да—Да—ДаДа—ДаДа
shannon-3 ДаДаДа—ДаДа—ДаДа
shannon-3-pro ДаДаДа—ДаДа—ДаДа
shannon-3.1 ДаДаДа—ДаДа—ДаДа
shannon-3.1-pro ДаДаДа—ДаДа—ДаДа
shannon-3.5 Да———ДаДа——Да
shannon-coder-1 Да—Да—ДаДа——Да

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

Id на хостван модел е неговото име и неговият вариант, свързани с тире, например DeepSeek-V4-Pro-0813-3BIT-REAP.

Модел ИнструментиИзображенияРазсъждениеУсилиеJSON обектJSON схемаКешТърсенеСтрийминг
DeepSeek-V4-Pro-0813 3BIT-REAP Да—ДаДаДаДаДа—Да
GLM-5.2 3BIT-REAP Да—ДаДаДаДаДа—Да
Kimi-K3 3BIT-REAP ДаДаДаДаДаДаДа—Да
Nemotron3Ultra 3BIT-REAP Да—ДаДаДаДаДа—Да
MiniMax-M3 3BIT-REAP ДаДаДаДаДаДаДа—Да
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP Да—ДаДаДаДаДа—Да
Kimi-K2.6 W4A16-AUTOROUND-REAP ДаДаДаДаДаДаДа—Да
Laguna-S-2.1 W4A16-AUTOROUND-REAP Да—ДаДа——Да—Да
inkling W4A16-AUTOROUND-REAP ДаДаДаДаДа—Да—Да
MiMo-V2.5-Pro W8A16 Да—ДаДаДаДаДа—Да
MiMo-V2.5 W8A16 ДаДаДаДаДаДаДа—Да
Hy3 W8A16 Да—ДаДаДаДаДа—Да

Какво означава всяка колона

  • Инструменти. Описвате функции в 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. Структурирани изходи
  • Кеширане на prompt-и. Prompt, който започва като скорошен prompt на същия модел, се чете от кеша, а кешираната част се таксува на 25% от цената на входа. Не изисква поле в заявката. Кеширане на prompt-и
  • Уеб търсене. С 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))

id и capabilities на два записа от data:

200 JSON
[
  {
    "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
    }
  }
]
Колона Флаг в capabilities
Инструменти tools
Вход с изображения vision
Разсъждение reasoning
Усилие за разсъждение reasoning_effort
JSON обект response_format
JSON схема json_schema
Кеширане на prompt-и prompt_caching
Уеб търсене Не е флаг: полето на заявката web_search.
Стрийминг streaming
  • 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 режим, които са извън неговия ред. Отказът идва, преди да бъде удържано нещо от баланса ви:

Статус Тип Съобщение Кога
400 invalid_request_error <id> does not accept image input Изображение е изпратено към хостван open-weight модел без вход с изображения.
400 invalid_request_error <id> does not accept response_format JSON изход е поискан от хостван open-weight модел, който няма нито един от двата JSON режима.
400 invalid_request_error <id> does not accept response_format json_schema; use json_object Схема е изпратена към хостван open-weight модел, който има само режим JSON обект.

Модел на Shannon отговаря на такава заявка със статус 200: възможността извън неговия ред не участва в отговора. Обработка на грешки