Możliwości
Co każdy model potrafi przez API, model po modelu: narzędzia, obraz na wejściu, wnioskowanie, wyjście JSON, prompt caching, wyszukiwanie w sieci i streaming.
Do każdego modelu docierasz przez te same trzy endpointy z tym samym kluczem. Dwie tabele pokazują, czym modele się różnią. Kreska oznacza, że model odpowiada bez tej możliwości.
Modele Shannon
| Model | Narzędzia | Obrazy | Wnioskowanie | Wysiłek | Obiekt JSON | Schemat JSON | Cache | Wyszukiwanie | Streaming |
|---|---|---|---|---|---|---|---|---|---|
shannon-1.6-lite | Tak | Tak | — | — | Tak | Tak | — | Tak | Tak |
shannon-1.6-pro | Tak | Tak | Tak | — | Tak | Tak | — | Tak | Tak |
shannon-2-lite | Tak | — | Tak | — | Tak | Tak | — | Tak | Tak |
shannon-2-pro | Tak | — | Tak | — | Tak | Tak | — | Tak | Tak |
shannon-3 | Tak | Tak | Tak | — | Tak | Tak | — | Tak | Tak |
shannon-3-pro | Tak | Tak | Tak | — | Tak | Tak | — | Tak | Tak |
shannon-3.1 | Tak | Tak | Tak | — | Tak | Tak | — | Tak | Tak |
shannon-3.1-pro | Tak | Tak | Tak | — | Tak | Tak | — | Tak | Tak |
shannon-3.5 | Tak | — | — | — | Tak | Tak | — | — | Tak |
shannon-coder-1 | Tak | — | Tak | — | Tak | Tak | — | — | Tak |
Hostowane modele open-weight
Id hostowanego modelu to jego nazwa i wariant połączone myślnikiem, na przykład DeepSeek-V4-Pro-0813-3BIT-REAP.
| Model | Narzędzia | Obrazy | Wnioskowanie | Wysiłek | Obiekt JSON | Schemat JSON | Cache | Wyszukiwanie | Streaming |
|---|---|---|---|---|---|---|---|---|---|
DeepSeek-V4-Pro-0813 3BIT-REAP | Tak | — | Tak | Tak | Tak | Tak | Tak | — | Tak |
GLM-5.2 3BIT-REAP | Tak | — | Tak | Tak | Tak | Tak | Tak | — | Tak |
Kimi-K3 3BIT-REAP | Tak | Tak | Tak | Tak | Tak | Tak | Tak | — | Tak |
Nemotron3Ultra 3BIT-REAP | Tak | — | Tak | Tak | Tak | Tak | Tak | — | Tak |
MiniMax-M3 3BIT-REAP | Tak | Tak | Tak | Tak | Tak | Tak | Tak | — | Tak |
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP | Tak | — | Tak | Tak | Tak | Tak | Tak | — | Tak |
Kimi-K2.6 W4A16-AUTOROUND-REAP | Tak | Tak | Tak | Tak | Tak | Tak | Tak | — | Tak |
Laguna-S-2.1 W4A16-AUTOROUND-REAP | Tak | — | Tak | Tak | — | — | Tak | — | Tak |
inkling W4A16-AUTOROUND-REAP | Tak | Tak | Tak | Tak | Tak | — | Tak | — | Tak |
MiMo-V2.5-Pro W8A16 | Tak | — | Tak | Tak | Tak | Tak | Tak | — | Tak |
MiMo-V2.5 W8A16 | Tak | Tak | Tak | Tak | Tak | Tak | Tak | — | Tak |
Hy3 W8A16 | Tak | — | Tak | Tak | Tak | Tak | Tak | — | Tak |
Co oznacza każda kolumna
- Narzędzia. Opisujesz funkcje w
tools, model odpowiada wywołaniami, które chce wykonać, a Twój kod je uruchamia. Każdy model przyjmuje narzędzia. Wymuszonetool_choicestosują hostowane modele open-weight. Wywołanie funkcji - Obraz na wejściu. Model czyta obrazy wysłane w wiadomości użytkownika, jako data URL lub jako adres.
shannon-2-liteishannon-2-proczytają obrazy w zapytaniach, które wysyłają takżetoolslubresponse_format. Rodzina Shannon 3 czyta także dokumenty. Obrazy i pliki - Wnioskowanie. Odpowiedź może zawierać tekst wnioskowania modelu obok odpowiedzi, we własnym polu. Wysiłek rozumowania
- Wysiłek rozumowania. Pole zapytania ustala, jak głęboko model wnioskuje:
off,low,mediumlubhigh. Modele Shannon same ustalają swoją głębokość. Wysiłek rozumowania - Obiekt JSON. Z
response_format: {"type": "json_object"}odpowiedź jest JSON-em bez narzuconego kształtu. W/v1/chat/completionsi/v1/responses. Ustrukturyzowane odpowiedzi - Schemat JSON. Z
response_formattypujson_schemaodpowiedź jest zgodna ze schematem, który wysyłasz. W/v1/chat/completionsi/v1/responses. Ustrukturyzowane odpowiedzi - Prompt caching. Prompt, który zaczyna się jak niedawny prompt w tym samym modelu, jest odczytywany z cache, a część z cache jest rozliczana po 25% ceny wejścia. Nie wymaga żadnego pola zapytania. Cache'owanie promptów
- Wyszukiwanie w sieci. Z
web_search: trueAPI przeszukuje sieć i przekazuje wyniki modelowi, zanim odpowie. W/v1/chat/completionsi/v1/messages. To pole zapytania i nie ma flagi wGET /v1/models. Wbudowane wyszukiwanie w sieci - Streaming. Z
stream: trueodpowiedź przychodzi jako server-sent events, w trakcie pisania przez model. Każdy model obsługuje streaming we wszystkich trzech endpointach. Streaming
Te same fakty z GET /v1/models
GET https://api.shannon-ai.com/v1/models
GET /v1/models wymienia każdy model z obiektem capabilities, więc program może odczytać te fakty zamiast tej strony. Endpoint nie wymaga klucza.
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 i capabilities dwóch pozycji 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
}
}
] | Kolumna | Flaga w capabilities |
|---|---|
| Narzędzia | tools |
| Obraz na wejściu | vision |
| Wnioskowanie | reasoning |
| Wysiłek rozumowania | reasoning_effort |
| Obiekt JSON | response_format |
| Schemat JSON | json_schema |
| Prompt caching | prompt_caching |
| Wyszukiwanie w sieci | To nie flaga: pole zapytania web_search. |
| Streaming | streaming |
response_formatiprompt_cachingto flagi pozycji hostowanych modeli open-weight. Pozycja Shannon raportuje wyjście JSON samymjson_schema, które oznacza oba tryby JSON.visionma wartośćtruedlashannon-2-liteishannon-2-pro: czytają one obrazy w zapytaniach, które wysyłają takżetoolslubresponse_format.
Poza wierszem modelu
Hostowany model open-weight odrzuca obraz lub tryb JSON spoza swojego wiersza. Odmowa następuje, zanim cokolwiek zostanie pobrane z Twojego salda:
| Status | Typ | Komunikat | Kiedy |
|---|---|---|---|
400 | invalid_request_error | <id> does not accept image input | Obraz wysłano do hostowanego modelu open-weight bez obsługi obrazu na wejściu. |
400 | invalid_request_error | <id> does not accept response_format | Zażądano wyjścia JSON od hostowanego modelu open-weight, który nie ma żadnego z trybów JSON. |
400 | invalid_request_error | <id> does not accept response_format json_schema; use json_object | Schemat wysłano do hostowanego modelu open-weight, który ma tylko tryb obiektu JSON. |
Model Shannon odpowiada na takie zapytanie ze statusem 200: możliwość spoza jego wiersza nie bierze udziału w odpowiedzi. Obsługa błędów