Funzionalità

Ogni modello si raggiunge tramite gli stessi tre endpoint con la stessa chiave. Le due tabelle mostrano dove i modelli differiscono. Un trattino significa che il modello risponde senza quella funzionalità.

Modelli Shannon

Modelli open-weight ospitati

L'id di un modello ospitato è il suo nome e la sua variante uniti da un trattino, per esempio DeepSeek-V4-Pro-0813-3BIT-REAP.

Cosa significa ogni colonna

• Tool. Descrivi le funzioni in tools, il modello risponde con le chiamate che vuole eseguire e il tuo codice le esegue. Ogni modello accetta i tool. Un tool_choice forzato viene applicato dai modelli open-weight ospitati. Chiamata di funzioni
• Input di immagini. Il modello legge le immagini inviate in un messaggio dell'utente, come data URL o come indirizzo. shannon-2-lite e shannon-2-pro leggono le immagini anche nelle richieste che inviano tools o response_format. La famiglia Shannon 3 legge anche i documenti. Immagini e file
• Ragionamento. La risposta può portare il testo del ragionamento del modello accanto alla risposta, in un campo a parte. Sforzo di ragionamento
• Sforzo di ragionamento. Un campo della richiesta imposta quanto in profondità ragiona il modello: off, low, medium o high. I modelli Shannon impostano da soli la propria profondità. Sforzo di ragionamento
• Oggetto JSON. Con response_format: {"type": "json_object"} la risposta è JSON senza una forma prescritta. Su /v1/chat/completions e /v1/responses. Output strutturati
• Schema JSON. Con response_format di tipo json_schema la risposta segue uno schema che invii tu. Su /v1/chat/completions e /v1/responses. Output strutturati
• Prompt caching. Un prompt che inizia come uno recente sullo stesso modello viene letto dalla cache, e la parte cached è fatturata al 25% del prezzo dell'input. Non richiede alcun campo nella richiesta. Prompt caching
• Ricerca web. Con web_search: true l'API cerca sul web e passa i risultati al modello prima che risponda. Su /v1/chat/completions e /v1/messages. È un campo della richiesta e non ha un flag in GET /v1/models. Ricerca web integrata
• Streaming. Con stream: true la risposta arriva come server-sent events mentre il modello scrive. Ogni modello supporta lo streaming su tutti e tre gli endpoint. Streaming

Gli stessi fatti da GET /v1/models

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

GET /v1/models elenca ogni modello con un oggetto capabilities, così un programma può leggere questi fatti invece di questa pagina. L'endpoint non richiede una chiave.

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 e le capabilities di due voci di data:

[
  {
    "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
    }
  }
]

• response_format e prompt_caching sono flag delle voci open-weight ospitate. Una voce Shannon riporta l'output JSON solo con json_schema, che vale per entrambe le modalità JSON.
• vision è true per shannon-2-lite e shannon-2-pro: leggono le immagini anche nelle richieste che inviano tools o response_format.

Fuori dalla riga di un modello

Un modello open-weight ospitato rifiuta un'immagine o una modalità JSON che non rientra nella sua riga. Il rifiuto avviene prima che venga prelevato qualcosa dal tuo saldo:

Un modello Shannon risponde a una richiesta del genere con stato 200: la funzionalità fuori dalla sua riga non influisce sulla risposta. Gestione errori