Capacidades

Lo que puede hacer cada modelo a través de la API, modelo por modelo: herramientas, entrada de imágenes, razonamiento, salida JSON, prompt caching, búsqueda web y streaming.

Se accede a todos los modelos a través de los mismos tres endpoints con la misma clave. Las dos tablas muestran en qué se diferencian los modelos. Un guion significa que el modelo responde sin esa capacidad.

Modelos Shannon

Modelo	Herramientas	Imágenes	Razonamiento	Esfuerzo	Objeto JSON	Esquema JSON	Caché	Búsqueda	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í

Modelos de pesos abiertos alojados

El id de un modelo alojado es su nombre y su variante unidos por un guion, por ejemplo DeepSeek-V4-Pro-0813-3BIT-REAP.

Modelo	Herramientas	Imágenes	Razonamiento	Esfuerzo	Objeto JSON	Esquema JSON	Caché	Búsqueda	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

Herramientas. Describes funciones en tools, el modelo responde con las llamadas que quiere que se hagan y tu código las ejecuta. Todos los modelos aceptan herramientas. Un tool_choice forzado lo aplican los modelos de pesos abiertos alojados. Llamadas a funciones
Entrada de imágenes. El modelo lee las imágenes enviadas dentro de un mensaje de usuario, como data URL o como dirección. shannon-2-lite y shannon-2-pro leen imágenes en solicitudes que también envían tools o response_format. La familia Shannon 3 también lee documentos. Imágenes y archivos
Razonamiento. La respuesta puede llevar el texto de razonamiento del modelo junto a la respuesta, en un campo propio. Esfuerzo de razonamiento
Esfuerzo de razonamiento. Un campo de la solicitud establece cuán a fondo razona el modelo: off, low, medium o high. Los modelos Shannon fijan su propia profundidad. Esfuerzo de razonamiento
Objeto JSON. Con response_format: {"type": "json_object"} la respuesta es JSON sin una forma prescrita. En /v1/chat/completions y /v1/responses. Salidas estructuradas
Esquema JSON. Con response_format de tipo json_schema la respuesta sigue un esquema que tú envías. En /v1/chat/completions y /v1/responses. Salidas estructuradas
Prompt caching. Un prompt que empieza como uno reciente en el mismo modelo se lee de la caché, y la parte en caché se factura al 25% del precio de entrada. No necesita ningún campo en la solicitud. Caché de prompts
Búsqueda web. Con web_search: true la API busca en la web y entrega los resultados al modelo antes de que responda. En /v1/chat/completions y /v1/messages. Es un campo de la solicitud y no tiene indicador en GET /v1/models. Búsqueda web integrada
Streaming. Con stream: true la respuesta llega como server-sent events mientras el modelo escribe. Todos los modelos hacen streaming en los tres endpoints. Streaming

Los mismos datos desde GET /v1/models

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

GET /v1/models lista cada modelo con un objeto capabilities, de modo que un programa puede leer estos datos en lugar de esta página. El endpoint no 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

El id y las capabilities de dos 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
Herramientas	`tools`
Entrada de imágenes	`vision`
Razonamiento	`reasoning`
Esfuerzo de razonamiento	`reasoning_effort`
Objeto JSON	`response_format`
Esquema JSON	`json_schema`
Prompt caching	`prompt_caching`
Búsqueda web	No es un indicador: el campo de solicitud `web_search`.
Streaming	`streaming`

response_format y prompt_caching son indicadores de las entradas de los modelos de pesos abiertos alojados. Una entrada de Shannon informa de la salida JSON solo con json_schema, que representa ambos modos JSON.
vision es true para shannon-2-lite y shannon-2-pro: leen imágenes en solicitudes que también envían tools o response_format.

Fuera de la fila de un modelo

Un modelo de pesos abiertos alojado rechaza una imagen o un modo JSON que está fuera de su fila. El rechazo ocurre antes de que se descuente nada de tu saldo:

Estado	Tipo	Mensaje	Cuándo
`400`	`invalid_request_error`	`<id> does not accept image input`	Se envió una imagen a un modelo de pesos abiertos alojado sin entrada de imágenes.
`400`	`invalid_request_error`	`<id> does not accept response_format`	Se pidió salida JSON a un modelo de pesos abiertos alojado que no tiene ninguno de los dos modos JSON.
`400`	`invalid_request_error`	`<id> does not accept response_format json_schema; use json_object`	Se envió un esquema a un modelo de pesos abiertos alojado que solo tiene el modo de objeto JSON.

Un modelo Shannon responde a una solicitud así con el estado 200: la capacidad fuera de su fila no interviene en la respuesta. Manejo de errores