Képességek

Minden modell ugyanazon a három végponton, ugyanazzal a kulccsal érhető el. A két táblázat megmutatja, miben térnek el a modellek. A kötőjel azt jelenti, hogy a modell e képesség nélkül válaszol.

Shannon modellek

Hosztolt nyílt súlyú modellek

A hosztolt modell azonosítója a neve és a változata kötőjellel összefűzve, például DeepSeek-V4-Pro-0813-3BIT-REAP.

Mit jelent az egyes oszlop

• Eszközök. A függvényeket a tools mezőben írod le, a modell a kért hívásokkal válaszol, a kódod pedig lefuttatja őket. Minden modell fogad eszközöket. A kényszerített tool_choice értéket a hosztolt nyílt súlyú modellek alkalmazzák. Funkcióhívás
• Képbemenet. A modell olvassa a felhasználói üzenetben küldött képeket, data URL-ként vagy címként. A shannon-2-lite és a shannon-2-pro olvassa a képeket azokban a kérésekben is, amelyek tools vagy response_format mezőt is küldenek. A Shannon 3 család dokumentumokat is olvas. Képek és fájlok
• Reasoning. A válasz a modell reasoning-szövegét is hordozhatja a válasz mellett, külön mezőben. Reasoning effort
• Reasoning effort. Egy kérésmező állítja be, mennyire mélyen gondolkodik a modell: off, low, medium vagy high. A Shannon modellek maguk állítják be a mélységet. Reasoning effort
• JSON-objektum. A response_format: {"type": "json_object"} esetén a válasz előírt alak nélküli JSON. A /v1/chat/completions és a /v1/responses végponton. Strukturált kimenetek
• JSON-séma. A json_schema típusú response_format esetén a válasz az általad küldött sémát követi. A /v1/chat/completions és a /v1/responses végponton. Strukturált kimenetek
• Prompt-gyorsítótárazás. Az a prompt, amely ugyanazon a modellen egy friss prompttal azonosan kezdődik, a gyorsítótárból olvasódik, és a gyorsítótárazott rész a bemeneti ár 25%-án számlázódik. Nem kell hozzá kérésmező. Prompt gyorsítványozás
• Webes keresés. A web_search: true esetén az API keres a weben, és a válasz előtt átadja az eredményeket a modellnek. A /v1/chat/completions és a /v1/messages végponton. Ez a kérés egy mezője, és nincs hozzá flag a GET /v1/models válaszban. Beépített webes keresés
• Streaming. A stream: true esetén a válasz server-sent eventsként érkezik, amíg a modell ír. Minden modell streamel mindhárom végponton. Streaming

Ugyanezek a tények a GET /v1/models végpontról

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

A GET /v1/models minden modellt capabilities objektummal listáz, így egy program ezeket a tényeket e lap helyett közvetlenül kiolvashatja. A végponthoz nem kell kulcs.

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

A data két elemének id és capabilities mezője:

[
  {
    "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
    }
  }
]

• A response_format és a prompt_caching a hosztolt nyílt súlyú elemek flagjei. A Shannon elem a JSON kimenetet egyedül a json_schema flaggel jelzi, amely mindkét JSON módot jelenti.
• A vision értéke true a shannon-2-lite és a shannon-2-pro esetén: olvassák a képeket azokban a kérésekben is, amelyek tools vagy response_format mezőt is küldenek.

Ami nem szerepel a modell sorában

A hosztolt nyílt súlyú modell visszautasítja a sorában nem szereplő képet vagy JSON módot. Az elutasítás azelőtt történik, hogy bármit levonnának az egyenlegedből:

A Shannon modell az ilyen kérésre 200 státusszal válaszol: a sorában nem szereplő képesség nem vesz részt a válaszban. Hibakezelés