Mogelijkheden

Wat elk model via de API kan, model voor model: tools, afbeeldingen als input, reasoning, JSON-output, prompt caching, web search en streaming.

Elk model is bereikbaar via dezelfde drie endpoints met dezelfde sleutel. De twee tabellen laten zien waar de modellen verschillen. Een streepje betekent dat het model antwoordt zonder die mogelijkheid.

Shannon-modellen

Model	Tools	Afbeeldingen	Reasoning	Effort	JSON-object	JSON-schema	Caching	Zoeken	Streaming
`shannon-1.6-lite`	Ja	Ja	—	—	Ja	Ja	—	Ja	Ja
`shannon-1.6-pro`	Ja	Ja	Ja	—	Ja	Ja	—	Ja	Ja
`shannon-2-lite`	Ja	—	Ja	—	Ja	Ja	—	Ja	Ja
`shannon-2-pro`	Ja	—	Ja	—	Ja	Ja	—	Ja	Ja
`shannon-3`	Ja	Ja	Ja	—	Ja	Ja	—	Ja	Ja
`shannon-3-pro`	Ja	Ja	Ja	—	Ja	Ja	—	Ja	Ja
`shannon-3.1`	Ja	Ja	Ja	—	Ja	Ja	—	Ja	Ja
`shannon-3.1-pro`	Ja	Ja	Ja	—	Ja	Ja	—	Ja	Ja
`shannon-3.5`	Ja	—	—	—	Ja	Ja	—	—	Ja
`shannon-coder-1`	Ja	—	Ja	—	Ja	Ja	—	—	Ja

Gehoste open-weight modellen

Het id van een gehost model is zijn naam en zijn variant, verbonden met een koppelteken, bijvoorbeeld DeepSeek-V4-Pro-0813-3BIT-REAP.

Model	Tools	Afbeeldingen	Reasoning	Effort	JSON-object	JSON-schema	Caching	Zoeken	Streaming
DeepSeek-V4-Pro-0813 `3BIT-REAP`	Ja	—	Ja	Ja	Ja	Ja	Ja	—	Ja
GLM-5.2 `3BIT-REAP`	Ja	—	Ja	Ja	Ja	Ja	Ja	—	Ja
Kimi-K3 `3BIT-REAP`	Ja	Ja	Ja	Ja	Ja	Ja	Ja	—	Ja
Nemotron3Ultra `3BIT-REAP`	Ja	—	Ja	Ja	Ja	Ja	Ja	—	Ja
MiniMax-M3 `3BIT-REAP`	Ja	Ja	Ja	Ja	Ja	Ja	Ja	—	Ja
DeepSeek-V4-Flash-0731 `W4A16-AUTOROUND-REAP`	Ja	—	Ja	Ja	Ja	Ja	Ja	—	Ja
Kimi-K2.6 `W4A16-AUTOROUND-REAP`	Ja	Ja	Ja	Ja	Ja	Ja	Ja	—	Ja
Laguna-S-2.1 `W4A16-AUTOROUND-REAP`	Ja	—	Ja	Ja	—	—	Ja	—	Ja
inkling `W4A16-AUTOROUND-REAP`	Ja	Ja	Ja	Ja	Ja	—	Ja	—	Ja
MiMo-V2.5-Pro `W8A16`	Ja	—	Ja	Ja	Ja	Ja	Ja	—	Ja
MiMo-V2.5 `W8A16`	Ja	Ja	Ja	Ja	Ja	Ja	Ja	—	Ja
Hy3 `W8A16`	Ja	—	Ja	Ja	Ja	Ja	Ja	—	Ja

Wat elke kolom betekent

Tools. Je beschrijft functies in tools, het model antwoordt met de calls die het wil laten uitvoeren en jouw code voert ze uit. Elk model accepteert tools. Een geforceerde tool_choice wordt toegepast door de gehoste open-weight modellen. Function calling
Afbeeldingen als input. Het model leest afbeeldingen die in een gebruikersbericht worden verzonden, als data-URL of als adres. shannon-2-lite en shannon-2-pro lezen afbeeldingen in aanvragen die ook tools of response_format meesturen. De Shannon 3-familie leest ook documenten. Afbeeldingen en bestanden
Reasoning. Het antwoord kan naast het antwoord zelf de reasoning-tekst van het model bevatten, in een eigen veld. Reasoning effort
Reasoning effort. Een requestveld bepaalt hoe diep het model redeneert: off, low, medium of high. De Shannon-modellen bepalen zelf hun diepte. Reasoning effort
JSON-object. Met response_format: {"type": "json_object"} is het antwoord JSON zonder voorgeschreven vorm. Op /v1/chat/completions en /v1/responses. Gestructureerde outputs
JSON-schema. Met response_format van het type json_schema volgt het antwoord een schema dat je meestuurt. Op /v1/chat/completions en /v1/responses. Gestructureerde outputs
Prompt caching. Een prompt die begint zoals een recente prompt op hetzelfde model, wordt uit de cache gelezen, en het gecachte deel wordt gefactureerd tegen 25% van de inputprijs. Er is geen requestveld voor nodig. Prompt-caching
Web search. Met web_search: true doorzoekt de API het web en geeft de resultaten aan het model voordat het antwoordt. Op /v1/chat/completions en /v1/messages. Het is een veld van de aanvraag en heeft geen vlag in GET /v1/models. Ingebouwde webzoekopdracht
Streaming. Met stream: true komt het antwoord als server-sent events binnen terwijl het model schrijft. Elk model streamt op alle drie de endpoints. Streaming

Dezelfde feiten uit GET /v1/models

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

GET /v1/models toont elk model met een capabilities-object, zodat een programma deze feiten kan lezen in plaats van deze pagina. Het endpoint heeft geen sleutel nodig.

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

De id en capabilities van twee items in data:

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
    }
  }
]

Kolom	Vlag in capabilities
Tools	`tools`
Afbeeldingen als input	`vision`
Reasoning	`reasoning`
Reasoning effort	`reasoning_effort`
JSON-object	`response_format`
JSON-schema	`json_schema`
Prompt caching	`prompt_caching`
Web search	Geen vlag: het requestveld `web_search`.
Streaming	`streaming`

response_format en prompt_caching zijn vlaggen van de gehoste open-weight items. Een Shannon-item meldt JSON-output alleen met json_schema, dat voor beide JSON-modi staat.
vision is true voor shannon-2-lite en shannon-2-pro: ze lezen afbeeldingen in aanvragen die ook tools of response_format meesturen.

Buiten de rij van een model

Een gehost open-weight model weigert een afbeelding of een JSON-modus die buiten zijn rij valt. De weigering komt voordat er iets van je saldo wordt afgeschreven:

Status	Type	Bericht	Wanneer
`400`	`invalid_request_error`	`<id> does not accept image input`	Er is een afbeelding verzonden naar een gehost open-weight model zonder afbeeldingen als input.
`400`	`invalid_request_error`	`<id> does not accept response_format`	JSON-output is gevraagd van een gehost open-weight model dat geen van beide JSON-modi heeft.
`400`	`invalid_request_error`	`<id> does not accept response_format json_schema; use json_object`	Er is een schema verzonden naar een gehost open-weight model dat alleen de JSON-objectmodus heeft.

Een Shannon-model beantwoordt zo'n aanvraag met status 200: de mogelijkheid buiten zijn rij speelt geen rol in het antwoord. Foutafhandeling