Capacidades

O que pode facer cada modelo a través da API, modelo por modelo: ferramentas, entrada de imaxe, razoamento, saída JSON, caché de prompts, busca web e streaming.

Accédese a todos os modelos a través dos mesmos tres endpoints coa mesma clave. As dúas táboas mostran onde difiren os modelos. Un guión significa que o modelo responde sen esa capacidade.

Modelos Shannon

Modelo	Ferramentas	Imaxes	Razoamento	Esforzo	Obxecto JSON	Esquema JSON	Caché	Busca	Streaming
`shannon-1.6-lite`	Si	Si	—	—	Si	Si	—	Si	Si
`shannon-1.6-pro`	Si	Si	Si	—	Si	Si	—	Si	Si
`shannon-2-lite`	Si	—	Si	—	Si	Si	—	Si	Si
`shannon-2-pro`	Si	—	Si	—	Si	Si	—	Si	Si
`shannon-3`	Si	Si	Si	—	Si	Si	—	Si	Si
`shannon-3-pro`	Si	Si	Si	—	Si	Si	—	Si	Si
`shannon-3.1`	Si	Si	Si	—	Si	Si	—	Si	Si
`shannon-3.1-pro`	Si	Si	Si	—	Si	Si	—	Si	Si
`shannon-3.5`	Si	—	—	—	Si	Si	—	—	Si
`shannon-coder-1`	Si	—	Si	—	Si	Si	—	—	Si

Modelos open-weight alojados

O id dun modelo alojado é o seu nome e a súa variante unidos por un guión, por exemplo DeepSeek-V4-Pro-0813-3BIT-REAP.

Modelo	Ferramentas	Imaxes	Razoamento	Esforzo	Obxecto JSON	Esquema JSON	Caché	Busca	Streaming
DeepSeek-V4-Pro-0813 `3BIT-REAP`	Si	—	Si	Si	Si	Si	Si	—	Si
GLM-5.2 `3BIT-REAP`	Si	—	Si	Si	Si	Si	Si	—	Si
Kimi-K3 `3BIT-REAP`	Si	Si	Si	Si	Si	Si	Si	—	Si
Nemotron3Ultra `3BIT-REAP`	Si	—	Si	Si	Si	Si	Si	—	Si
MiniMax-M3 `3BIT-REAP`	Si	Si	Si	Si	Si	Si	Si	—	Si
DeepSeek-V4-Flash-0731 `W4A16-AUTOROUND-REAP`	Si	—	Si	Si	Si	Si	Si	—	Si
Kimi-K2.6 `W4A16-AUTOROUND-REAP`	Si	Si	Si	Si	Si	Si	Si	—	Si
Laguna-S-2.1 `W4A16-AUTOROUND-REAP`	Si	—	Si	Si	—	—	Si	—	Si
inkling `W4A16-AUTOROUND-REAP`	Si	Si	Si	Si	Si	—	Si	—	Si
MiMo-V2.5-Pro `W8A16`	Si	—	Si	Si	Si	Si	Si	—	Si
MiMo-V2.5 `W8A16`	Si	Si	Si	Si	Si	Si	Si	—	Si
Hy3 `W8A16`	Si	—	Si	Si	Si	Si	Si	—	Si

Que significa cada columna

Ferramentas. Describes funcións en tools, o modelo responde coas chamadas que quere que se fagan e o teu código execútaas. Todos os modelos aceptan ferramentas. Os modelos open-weight alojados aplican un tool_choice forzado. Chamadas a funcións
Entrada de imaxe. O modelo le as imaxes enviadas dentro dunha mensaxe de usuario, como data URL ou como enderezo. shannon-2-lite e shannon-2-pro len imaxes en solicitudes que tamén envían tools ou response_format. A familia Shannon 3 le tamén documentos. Imaxes e ficheiros
Razoamento. A resposta pode levar o texto de razoamento do modelo xunto coa resposta, nun campo propio. Esforzo de razoamento
Esforzo de razoamento. Un campo da solicitude define a profundidade do razoamento do modelo: off, low, medium ou high. Os modelos Shannon definen a súa propia profundidade. Esforzo de razoamento
Obxecto JSON. Con response_format: {"type": "json_object"} a resposta é JSON sen unha forma prescrita. En /v1/chat/completions e /v1/responses. Saídas estruturadas
Esquema JSON. Con response_format de tipo json_schema a resposta segue un esquema que ti envías. En /v1/chat/completions e /v1/responses. Saídas estruturadas
Caché de prompts. Un prompt que comeza como outro recente no mesmo modelo lese da caché, e a parte en caché factúrase ao 25% do prezo de entrada. Non necesita ningún campo na solicitude. Caché de prompts
Busca web. Con web_search: true a API busca na web e dálle os resultados ao modelo antes de que responda. En /v1/chat/completions e /v1/messages. É un campo da solicitude e non ten indicador en GET /v1/models. Busca web
Streaming. Con stream: true a resposta chega como server-sent events mentres o modelo escribe. Todos os modelos fan streaming nos tres endpoints. Streaming

Os mesmos datos desde GET /v1/models

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

GET /v1/models lista todos os modelos cun obxecto capabilities, así que un programa pode ler estes datos en lugar desta páxina. O endpoint non necesita clave.

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

O id e capabilities de dúas entradas 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 en capabilities
Ferramentas	`tools`
Entrada de imaxe	`vision`
Razoamento	`reasoning`
Esforzo de razoamento	`reasoning_effort`
Obxecto JSON	`response_format`
Esquema JSON	`json_schema`
Caché de prompts	`prompt_caching`
Busca web	Non é un indicador: o campo de solicitude `web_search`.
Streaming	`streaming`

response_format e prompt_caching son indicadores das entradas de modelos open-weight alojados. Unha entrada de Shannon informa da saída JSON só con json_schema, que representa os dous modos JSON.
vision é true para shannon-2-lite e shannon-2-pro: len imaxes en solicitudes que tamén envían tools ou response_format.

Fóra da fila dun modelo

Un modelo open-weight alojado rexeita unha imaxe ou un modo JSON que está fóra da súa fila. O rexeitamento prodúcese antes de descontar nada do teu saldo:

Estado	Tipo	Mensaxe	Cando
`400`	`invalid_request_error`	`<id> does not accept image input`	Enviouse unha imaxe a un modelo open-weight alojado sen entrada de imaxe.
`400`	`invalid_request_error`	`<id> does not accept response_format`	Pediuse saída JSON a un modelo open-weight alojado que non ten ningún dos dous modos JSON.
`400`	`invalid_request_error`	`<id> does not accept response_format json_schema; use json_object`	Enviouse un esquema a un modelo open-weight alojado que só ten o modo de obxecto JSON.

Un modelo Shannon responde a esa solicitude co estado 200: a capacidade que está fóra da súa fila non participa na resposta. Xestión de erros