Възможности
Какво може всеки модел през 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: trueAPI търси в мрежата и дава резултатите на модела, преди той да отговори. На/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
}
}
] | Колона | Флаг в 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: възможността извън неговия ред не участва в отговора. Обработка на грешки