Možnosti

Ku každému modelu sa dostanete cez rovnaké tri endpointy s rovnakým kľúčom. Dve tabuľky ukazujú, v čom sa modely líšia. Pomlčka znamená, že model odpovedá bez tejto schopnosti.

Modely Shannon

Hostované open-weight modely

Id hostovaného modelu je jeho názov a variant spojené pomlčkou, napríklad DeepSeek-V4-Pro-0813-3BIT-REAP.

Čo znamená každý stĺpec

• Nástroje. Funkcie popíšete v tools, model odpovie volaniami, ktoré chce vykonať, a váš kód ich spustí. Každý model berie nástroje. Vynútené tool_choice uplatňujú hostované open-weight modely. Volanie funkcií
• Obrázkový vstup. Model číta obrázky poslané v správe používateľa, ako data URL alebo ako adresu. shannon-2-lite a shannon-2-pro čítajú obrázky aj v requestoch, ktoré posielajú tools alebo response_format. Rodina Shannon 3 číta aj dokumenty. Obrázky a súbory
• Uvažovanie. Odpoveď môže popri odpovedi niesť text uvažovania modelu, vo vlastnom poli. Úsilie pri uvažovaní
• Úsilie pri uvažovaní. Pole requestu určuje, ako hlboko model uvažuje: off, low, medium alebo high. Modely Shannon si hĺbku nastavujú samy. Úsilie pri uvažovaní
• Objekt JSON. S response_format: {"type": "json_object"} je odpoveď JSON bez predpísaného tvaru. Na /v1/chat/completions a /v1/responses. Štruktúrované výstupy
• JSON schéma. S response_format typu json_schema odpoveď sleduje schému, ktorú pošlete. Na /v1/chat/completions a /v1/responses. Štruktúrované výstupy
• Prompt caching. Prompt, ktorý začína ako nedávny prompt na tom istom modeli, sa číta z cache a cachovaná časť sa účtuje za 25 % ceny vstupu. Nepotrebuje žiadne pole requestu. Caching promptov
• Webové vyhľadávanie. S web_search: true API vyhľadá na webe a dá výsledky modelu skôr, než odpovie. Na /v1/chat/completions a /v1/messages. Je to pole requestu a v GET /v1/models nemá príznak. Vstavané webové vyhľadávanie
• Streamovanie. S stream: true odpoveď prichádza ako server-sent events, kým model píše. Každý model streamuje na všetkých troch endpointoch. Streamovanie

Rovnaké fakty z GET /v1/models

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

GET /v1/models vypíše každý model s objektom capabilities, takže program môže tieto fakty čítať namiesto tejto stránky. Endpoint nepotrebuje kľúč.

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 a capabilities dvoch položiek v 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 a prompt_caching sú príznaky položiek hostovaných open-weight modelov. Položka Shannon hlási výstup JSON samotným json_schema, ktoré zastupuje oba režimy JSON.
• vision je true pre shannon-2-lite a shannon-2-pro: čítajú obrázky aj v requestoch, ktoré posielajú tools alebo response_format.

Mimo riadka modelu

Hostovaný open-weight model odmietne obrázok alebo režim JSON, ktorý je mimo jeho riadka. Odmietnutie príde skôr, než sa niečo odpočíta z vášho zostatku:

Model Shannon na takýto request odpovie so stavom 200: schopnosť mimo jeho riadka sa na odpovedi nepodieľa. Spracovanie chýb