Võimekused

Iga mudelini jõuab samade kolme lõpp-punkti kaudu sama võtmega. Kaks tabelit näitavad, kus mudelid erinevad. Kriips tähendab, et mudel vastab ilma selle võimekuseta.

Shannoni mudelid

Hostitud avatud kaaludega mudelid

Hostitud mudeli id on tema nimi ja variant, ühendatud sidekriipsuga, näiteks DeepSeek-V4-Pro-0813-3BIT-REAP.

Mida iga veerg tähendab

• Tööriistad. Sa kirjeldad funktsioonid väljas tools, mudel vastab kutsetega, mida ta soovib teha, ja sinu kood käivitab need. Iga mudel võtab tööriistu. Sunnitud tool_choice rakendavad hostitud avatud kaaludega mudelid. Funktsioonikutse
• Pildisisend. Mudel loeb kasutaja sõnumis saadetud pilte, data URL-ina või aadressina. shannon-2-lite ja shannon-2-pro loevad pilte ka päringutes, mis saadavad samuti tools või response_format. Shannon 3 perekond loeb ka dokumente. Pildid ja failid
• Arutlus. Vastus võib vastuse kõrval kanda mudeli arutlusteksti eraldi väljal. Reasoning-pingutus
• Arutluse pingutus. Päringuväli määrab, kui sügavalt mudel arutleb: off, low, medium või high. Shannoni mudelid määravad sügavuse ise. Reasoning-pingutus
• JSON-objekt. Kui response_format: {"type": "json_object"}, on vastus JSON ilma ettekirjutatud kujuta. Lõpp-punktides /v1/chat/completions ja /v1/responses. Struktureeritud väljundid
• JSON schema. Kui response_format on tüüpi json_schema, järgib vastus sinu saadetud skeemi. Lõpp-punktides /v1/chat/completions ja /v1/responses. Struktureeritud väljundid
• Prompti vahemällu panek. Prompt, mis algab nagu hiljutine prompt samal mudelil, loetakse vahemälust ja vahemälus olevat osa arveldatakse 25% sisendi hinnast. See ei vaja päringuvälja. Prompti vahemäljutamine
• Veebiotsing. Kui web_search: true, otsib API veebist ja annab tulemused mudelile enne vastamist. Lõpp-punktides /v1/chat/completions ja /v1/messages. See on päringu väli ja sellel ei ole lippu päringus GET /v1/models. Veebiotsing
• Voogedastus. Kui stream: true, saabub vastus server-sent events kujul, kuni mudel kirjutab. Iga mudel voogedastab kõigis kolmes lõpp-punktis. Voogedastus

Samad faktid päringust GET /v1/models

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

GET /v1/models loetleb iga mudeli koos capabilities-objektiga, nii et programm saab need faktid lugeda selle lehe asemel. Lõpp-punkt ei vaja võtit.

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

Kahe data kirje id ja capabilities:

[
  {
    "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 ja prompt_caching on hostitud avatud kaaludega kirjete lipud. Shannoni kirje teatab JSON-väljundist ainult lipuga json_schema, mis tähistab mõlemat JSON-režiimi.
• vision on true mudelitel shannon-2-lite ja shannon-2-pro: nad loevad pilte ka päringutes, mis saadavad samuti tools või response_format.

Mudeli reast väljas

Hostitud avatud kaaludega mudel keeldub pildist või JSON-režiimist, mis jääb tema rea ootusest välja. Keeldumine tuleb enne, kui sinu saldost midagi maha arvatakse:

Shannoni mudel vastab sellisele päringule olekuga 200: võimekus, mis jääb tema reast välja, vastuses osa ei võta. Vigade käsitlus