Siirry sisältöön
Ominaisuudet

Ominaisuudet

Mitä kukin malli osaa API:n kautta, malli mallilta: työkalut, kuvasyöte, päättely, JSON-tuloste, prompt-välimuistitus, verkkohaku ja suoratoisto.

Kaikkiin malleihin pääsee samojen kolmen päätepisteen kautta samalla avaimella. Kaksi taulukkoa näyttää, missä mallit eroavat. Viiva tarkoittaa, että malli vastaa ilman kyseistä ominaisuutta.

Shannon-mallit

Malli TyökalutKuvatPäättelyTehoJSON-objektiJSON-skeemaVälimuistiHakuSuoratoisto
shannon-1.6-lite KylläKyllä——KylläKyllä—KylläKyllä
shannon-1.6-pro KylläKylläKyllä—KylläKyllä—KylläKyllä
shannon-2-lite Kyllä—Kyllä—KylläKyllä—KylläKyllä
shannon-2-pro Kyllä—Kyllä—KylläKyllä—KylläKyllä
shannon-3 KylläKylläKyllä—KylläKyllä—KylläKyllä
shannon-3-pro KylläKylläKyllä—KylläKyllä—KylläKyllä
shannon-3.1 KylläKylläKyllä—KylläKyllä—KylläKyllä
shannon-3.1-pro KylläKylläKyllä—KylläKyllä—KylläKyllä
shannon-3.5 Kyllä———KylläKyllä——Kyllä
shannon-coder-1 Kyllä—Kyllä—KylläKyllä——Kyllä

Hostatut avoimen painon mallit

Hostatun mallin id on sen nimi ja variantti yhdistettynä yhdysmerkillä, esimerkiksi DeepSeek-V4-Pro-0813-3BIT-REAP.

Malli TyökalutKuvatPäättelyTehoJSON-objektiJSON-skeemaVälimuistiHakuSuoratoisto
DeepSeek-V4-Pro-0813 3BIT-REAP Kyllä—KylläKylläKylläKylläKyllä—Kyllä
GLM-5.2 3BIT-REAP Kyllä—KylläKylläKylläKylläKyllä—Kyllä
Kimi-K3 3BIT-REAP KylläKylläKylläKylläKylläKylläKyllä—Kyllä
Nemotron3Ultra 3BIT-REAP Kyllä—KylläKylläKylläKylläKyllä—Kyllä
MiniMax-M3 3BIT-REAP KylläKylläKylläKylläKylläKylläKyllä—Kyllä
DeepSeek-V4-Flash-0731 W4A16-AUTOROUND-REAP Kyllä—KylläKylläKylläKylläKyllä—Kyllä
Kimi-K2.6 W4A16-AUTOROUND-REAP KylläKylläKylläKylläKylläKylläKyllä—Kyllä
Laguna-S-2.1 W4A16-AUTOROUND-REAP Kyllä—KylläKyllä——Kyllä—Kyllä
inkling W4A16-AUTOROUND-REAP KylläKylläKylläKylläKyllä—Kyllä—Kyllä
MiMo-V2.5-Pro W8A16 Kyllä—KylläKylläKylläKylläKyllä—Kyllä
MiMo-V2.5 W8A16 KylläKylläKylläKylläKylläKylläKyllä—Kyllä
Hy3 W8A16 Kyllä—KylläKylläKylläKylläKyllä—Kyllä

Mitä kukin sarake tarkoittaa

  • Työkalut. Kuvaat funktiot kentässä tools, malli vastaa kutsuilla, jotka se haluaa tehtäväksi, ja koodisi suorittaa ne. Jokainen malli ottaa työkaluja. Pakotetun tool_choice-arvon soveltavat hostatut avoimen painon mallit. Toiminto kutsu
  • Kuvasyöte. Malli lukee käyttäjän viestissä lähetetyt kuvat data-URL:na tai osoitteena. shannon-2-lite ja shannon-2-pro lukevat kuvia myös pyynnöissä, jotka lähettävät tools- tai response_format-kentän. Shannon 3 -perhe lukee myös dokumentteja. Kuvat ja tiedostot
  • Päättely. Vastaus voi sisältää mallin päättelytekstin vastauksen rinnalla omassa kentässään. Päättelyn teho
  • Päättelyn teho. Pyynnön kenttä määrää, kuinka syvästi malli päättelee: off, low, medium tai high. Shannon-mallit määrittävät syvyytensä itse. Päättelyn teho
  • JSON-objekti. Kun käytössä on response_format: {"type": "json_object"}, vastaus on JSONia ilman määrättyä muotoa. Päätepisteissä /v1/chat/completions ja /v1/responses. Strukturoidut lähdöt
  • JSON-skeema. Kun response_format on tyyppiä json_schema, vastaus noudattaa lähettämääsi skeemaa. Päätepisteissä /v1/chat/completions ja /v1/responses. Strukturoidut lähdöt
  • Prompt-välimuistitus. Prompt, joka alkaa kuten viimeaikainen prompt samalla mallilla, luetaan välimuistista, ja välimuistista luettu osa laskutetaan 25 %:lla syötteen hinnasta. Se ei tarvitse pyynnön kenttää. Prompt-välimuistitus
  • Verkkohaku. Kun web_search: true, API hakee verkosta ja antaa tulokset mallille ennen vastaamista. Päätepisteissä /v1/chat/completions ja /v1/messages. Se on pyynnön kenttä, eikä sillä ole lippua kohteessa GET /v1/models. Sisäänrakennettu verkkohaku
  • Suoratoisto. Kun stream: true, vastaus saapuu server-sent events -tapahtumina mallin kirjoittaessa. Jokainen malli suoratoistaa kaikissa kolmessa päätepisteessä. Suoratoisto

Samat tiedot päätepisteestä GET /v1/models

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

GET /v1/models listaa jokaisen mallin capabilities-objektin kanssa, joten ohjelma voi lukea nämä tiedot tämän sivun sijaan. Päätepiste ei tarvitse avainta.

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))

Kahden data-merkinnän id ja capabilities:

200 JSON
[
  {
    "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
    }
  }
]
Sarake Lippu kentässä capabilities
Työkalut tools
Kuvasyöte vision
Päättely reasoning
Päättelyn teho reasoning_effort
JSON-objekti response_format
JSON-skeema json_schema
Prompt-välimuistitus prompt_caching
Verkkohaku Ei lippu: pyynnön kenttä web_search.
Suoratoisto streaming
  • response_format ja prompt_caching ovat hostattujen avoimen painon merkintöjen lippuja. Shannon-merkintä ilmoittaa JSON-tulosteen pelkällä json_schema-lipulla, joka tarkoittaa molempia JSON-tiloja.
  • vision on true malleille shannon-2-lite ja shannon-2-pro: ne lukevat kuvia myös pyynnöissä, jotka lähettävät tools- tai response_format-kentän.

Mallin rivin ulkopuolella

Hostattu avoimen painon malli hylkää kuvan tai JSON-tilan, joka ei kuulu sen riville. Hylkäys tulee ennen kuin saldostasi veloitetaan mitään:

Tila Tyyppi Viesti Milloin
400 invalid_request_error <id> does not accept image input Kuva lähetettiin hostatulle avoimen painon mallille, joka ei tue kuvasyötettä.
400 invalid_request_error <id> does not accept response_format JSON-tulostetta pyydettiin hostatulta avoimen painon mallilta, jolla ei ole kumpaakaan JSON-tilaa.
400 invalid_request_error <id> does not accept response_format json_schema; use json_object Skeema lähetettiin hostatulle avoimen painon mallille, jolla on vain JSON-objektitila.

Shannon-malli vastaa tällaiseen pyyntöön tilalla 200: rivinsä ulkopuolinen ominaisuus ei vaikuta vastaukseen. Virheiden käsittely