Capacitats

Què pot fer cada model a través de l'API, model per model: eines, entrada d'imatge, raonament, sortida JSON, prompt caching, cerca web i streaming.

S'arriba a tots els models pels mateixos tres endpoints amb la mateixa clau. Les dues taules mostren on es diferencien els models. Un guió vol dir que el model respon sense aquesta capacitat.

Models Shannon

Model	Eines	Imatges	Raonament	Esforç	Objecte JSON	Esquema JSON	Cache	Cerca	Streaming
`shannon-1.6-lite`	Sí	Sí	—	—	Sí	Sí	—	Sí	Sí
`shannon-1.6-pro`	Sí	Sí	Sí	—	Sí	Sí	—	Sí	Sí
`shannon-2-lite`	Sí	—	Sí	—	Sí	Sí	—	Sí	Sí
`shannon-2-pro`	Sí	—	Sí	—	Sí	Sí	—	Sí	Sí
`shannon-3`	Sí	Sí	Sí	—	Sí	Sí	—	Sí	Sí
`shannon-3-pro`	Sí	Sí	Sí	—	Sí	Sí	—	Sí	Sí
`shannon-3.1`	Sí	Sí	Sí	—	Sí	Sí	—	Sí	Sí
`shannon-3.1-pro`	Sí	Sí	Sí	—	Sí	Sí	—	Sí	Sí
`shannon-3.5`	Sí	—	—	—	Sí	Sí	—	—	Sí
`shannon-coder-1`	Sí	—	Sí	—	Sí	Sí	—	—	Sí

Models open-weight hostejats

L'id d'un model hostejat és el seu nom i la seva variant units per un guionet, per exemple DeepSeek-V4-Pro-0813-3BIT-REAP.

Model	Eines	Imatges	Raonament	Esforç	Objecte JSON	Esquema JSON	Cache	Cerca	Streaming
DeepSeek-V4-Pro-0813 `3BIT-REAP`	Sí	—	Sí	Sí	Sí	Sí	Sí	—	Sí
GLM-5.2 `3BIT-REAP`	Sí	—	Sí	Sí	Sí	Sí	Sí	—	Sí
Kimi-K3 `3BIT-REAP`	Sí	Sí	Sí	Sí	Sí	Sí	Sí	—	Sí
Nemotron3Ultra `3BIT-REAP`	Sí	—	Sí	Sí	Sí	Sí	Sí	—	Sí
MiniMax-M3 `3BIT-REAP`	Sí	Sí	Sí	Sí	Sí	Sí	Sí	—	Sí
DeepSeek-V4-Flash-0731 `W4A16-AUTOROUND-REAP`	Sí	—	Sí	Sí	Sí	Sí	Sí	—	Sí
Kimi-K2.6 `W4A16-AUTOROUND-REAP`	Sí	Sí	Sí	Sí	Sí	Sí	Sí	—	Sí
Laguna-S-2.1 `W4A16-AUTOROUND-REAP`	Sí	—	Sí	Sí	—	—	Sí	—	Sí
inkling `W4A16-AUTOROUND-REAP`	Sí	Sí	Sí	Sí	Sí	—	Sí	—	Sí
MiMo-V2.5-Pro `W8A16`	Sí	—	Sí	Sí	Sí	Sí	Sí	—	Sí
MiMo-V2.5 `W8A16`	Sí	Sí	Sí	Sí	Sí	Sí	Sí	—	Sí
Hy3 `W8A16`	Sí	—	Sí	Sí	Sí	Sí	Sí	—	Sí

Què significa cada columna

Eines. Descrius funcions a tools, el model respon amb les crides que vol fer i el teu codi les executa. Tots els models admeten eines. Els models open-weight hostejats apliquen un tool_choice forçat. Crida de funcions
Entrada d'imatge. El model llegeix les imatges enviades dins d'un missatge d'usuari, com a URL de dades o com a adreça. shannon-2-lite i shannon-2-pro llegeixen imatges en sol·licituds que també envien tools o response_format. La família Shannon 3 també llegeix documents. Imatges i fitxers
Raonament. La resposta pot portar el text de raonament del model al costat de la resposta, en un camp propi. Esforç de raonament
Esforç de raonament. Un camp de la sol·licitud defineix com de profundament raona el model: off, low, medium o high. Els models Shannon fixen la seva pròpia profunditat. Esforç de raonament
Objecte JSON. Amb response_format: {"type": "json_object"} la resposta és JSON sense una forma prescrita. A /v1/chat/completions i /v1/responses. Sortides estructurades
Esquema JSON. Amb response_format de tipus json_schema la resposta segueix un esquema que envies. A /v1/chat/completions i /v1/responses. Sortides estructurades
Prompt caching. Un prompt que comença com un de recent al mateix model es llegeix de la cache, i la part en cache es factura al 25% del preu d'entrada. No necessita cap camp de sol·licitud. Caching de prompts
Cerca web. Amb web_search: true l'API cerca al web i dona els resultats al model abans que respongui. A /v1/chat/completions i /v1/messages. És un camp de la sol·licitud i no té cap indicador a GET /v1/models. Cerca web
Streaming. Amb stream: true la resposta arriba com a server-sent events mentre el model escriu. Tots els models fan streaming als tres endpoints. Streaming

Els mateixos fets des de GET /v1/models

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

GET /v1/models llista cada model amb un objecte capabilities, de manera que un programa pot llegir aquests fets en lloc d'aquesta pàgina. L'endpoint no necessita clau.

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

L'id i les capabilities de dues entrades de 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
    }
  }
]

Columna	Indicador a capabilities
Eines	`tools`
Entrada d'imatge	`vision`
Raonament	`reasoning`
Esforç de raonament	`reasoning_effort`
Objecte JSON	`response_format`
Esquema JSON	`json_schema`
Prompt caching	`prompt_caching`
Cerca web	No és un indicador: el camp de sol·licitud `web_search`.
Streaming	`streaming`

response_format i prompt_caching són indicadors de les entrades open-weight hostejades. Una entrada Shannon informa de la sortida JSON només amb json_schema, que representa tots dos modes JSON.
vision és true per a shannon-2-lite i shannon-2-pro: llegeixen imatges en sol·licituds que també envien tools o response_format.

Fora de la fila d'un model

Un model open-weight hostejat rebutja una imatge o un mode JSON que queda fora de la seva fila. El rebuig arriba abans que es descompti res del teu saldo:

Estat	Tipus	Missatge	Quan
`400`	`invalid_request_error`	`<id> does not accept image input`	S'ha enviat una imatge a un model open-weight hostejat sense entrada d'imatge.
`400`	`invalid_request_error`	`<id> does not accept response_format`	S'ha demanat sortida JSON a un model open-weight hostejat que no té cap dels dos modes JSON.
`400`	`invalid_request_error`	`<id> does not accept response_format json_schema; use json_object`	S'ha enviat un esquema a un model open-weight hostejat que només té el mode d'objecte JSON.

Un model Shannon respon a una sol·licitud així amb l'estat 200: la capacitat fora de la seva fila no participa en la resposta. Gestió d’errors