Capabilități

Ce poate face fiecare model prin API, model cu model: instrumente, imagine la intrare, raționament, ieșire JSON, caching de prompt, căutare web și streaming.

Fiecare model este accesat prin aceleași trei endpoint-uri, cu aceeași cheie. Cele două tabele arată prin ce diferă modelele. O liniuță înseamnă că modelul răspunde fără acea capabilitate.

Modele Shannon

Model	Instrumente	Imagini	Raționament	Efort	Obiect JSON	Schemă JSON	Caching	Căutare	Streaming
`shannon-1.6-lite`	Da	Da	—	—	Da	Da	—	Da	Da
`shannon-1.6-pro`	Da	Da	Da	—	Da	Da	—	Da	Da
`shannon-2-lite`	Da	—	Da	—	Da	Da	—	Da	Da
`shannon-2-pro`	Da	—	Da	—	Da	Da	—	Da	Da
`shannon-3`	Da	Da	Da	—	Da	Da	—	Da	Da
`shannon-3-pro`	Da	Da	Da	—	Da	Da	—	Da	Da
`shannon-3.1`	Da	Da	Da	—	Da	Da	—	Da	Da
`shannon-3.1-pro`	Da	Da	Da	—	Da	Da	—	Da	Da
`shannon-3.5`	Da	—	—	—	Da	Da	—	—	Da
`shannon-coder-1`	Da	—	Da	—	Da	Da	—	—	Da

Modele open-weight găzduite

Id-ul unui model găzduit este numele și varianta lui unite printr-o cratimă, de exemplu DeepSeek-V4-Pro-0813-3BIT-REAP.

Model	Instrumente	Imagini	Raționament	Efort	Obiect JSON	Schemă JSON	Caching	Căutare	Streaming
DeepSeek-V4-Pro-0813 `3BIT-REAP`	Da	—	Da	Da	Da	Da	Da	—	Da
GLM-5.2 `3BIT-REAP`	Da	—	Da	Da	Da	Da	Da	—	Da
Kimi-K3 `3BIT-REAP`	Da	Da	Da	Da	Da	Da	Da	—	Da
Nemotron3Ultra `3BIT-REAP`	Da	—	Da	Da	Da	Da	Da	—	Da
MiniMax-M3 `3BIT-REAP`	Da	Da	Da	Da	Da	Da	Da	—	Da
DeepSeek-V4-Flash-0731 `W4A16-AUTOROUND-REAP`	Da	—	Da	Da	Da	Da	Da	—	Da
Kimi-K2.6 `W4A16-AUTOROUND-REAP`	Da	Da	Da	Da	Da	Da	Da	—	Da
Laguna-S-2.1 `W4A16-AUTOROUND-REAP`	Da	—	Da	Da	—	—	Da	—	Da
inkling `W4A16-AUTOROUND-REAP`	Da	Da	Da	Da	Da	—	Da	—	Da
MiMo-V2.5-Pro `W8A16`	Da	—	Da	Da	Da	Da	Da	—	Da
MiMo-V2.5 `W8A16`	Da	Da	Da	Da	Da	Da	Da	—	Da
Hy3 `W8A16`	Da	—	Da	Da	Da	Da	Da	—	Da

Ce înseamnă fiecare coloană

Instrumente. Descrii funcții în tools, modelul răspunde cu apelurile pe care vrea să le facă, iar codul tău le rulează. Fiecare model acceptă instrumente. Un tool_choice forțat este aplicat de modelele open-weight găzduite. Apelare funcții
Imagine la intrare. Modelul citește imaginile trimise într-un mesaj al utilizatorului, ca data URL sau ca adresă. shannon-2-lite și shannon-2-pro citesc imagini în cereri care trimit și tools sau response_format. Familia Shannon 3 citește și documente. Imagini și fișiere
Raționament. Răspunsul poate purta textul de raționament al modelului alături de răspuns, într-un câmp separat. Efort de raționament
Efort de raționament. Un câmp al cererii stabilește cât de profund raționează modelul: off, low, medium sau high. Modelele Shannon își stabilesc singure profunzimea. Efort de raționament
Obiect JSON. Cu response_format: {"type": "json_object"}, răspunsul este JSON fără o formă prescrisă. Pe /v1/chat/completions și /v1/responses. Rezultate structurate
Schemă JSON. Cu response_format de tip json_schema, răspunsul urmează o schemă trimisă de tine. Pe /v1/chat/completions și /v1/responses. Rezultate structurate
Caching de prompt. Un prompt care începe ca unul recent pe același model este citit din cache, iar partea din cache este facturată la 25% din prețul de intrare. Nu necesită niciun câmp în cerere. Caching de prompt
Căutare web. Cu web_search: true, API-ul caută pe web și dă rezultatele modelului înainte să răspundă. Pe /v1/chat/completions și /v1/messages. Este un câmp al cererii și nu are indicator în GET /v1/models. Căutare web integrată
Streaming. Cu stream: true, răspunsul sosește ca server-sent events pe măsură ce modelul scrie. Fiecare model face streaming pe toate cele trei endpoint-uri. Streaming

Aceleași informații din GET /v1/models

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

GET /v1/models listează fiecare model cu un obiect capabilities, astfel încât un program poate citi aceste informații în loc de această pagină. Endpoint-ul nu necesită cheie.

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

id și capabilities pentru două intrări din 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
    }
  }
]

Coloană	Indicator în capabilities
Instrumente	`tools`
Imagine la intrare	`vision`
Raționament	`reasoning`
Efort de raționament	`reasoning_effort`
Obiect JSON	`response_format`
Schemă JSON	`json_schema`
Caching de prompt	`prompt_caching`
Căutare web	Nu este un indicator: câmpul de cerere `web_search`.
Streaming	`streaming`

response_format și prompt_caching sunt indicatori ai intrărilor open-weight găzduite. O intrare Shannon raportează ieșirea JSON doar prin json_schema, care înseamnă ambele moduri JSON.
vision este true pentru shannon-2-lite și shannon-2-pro: ele citesc imagini în cereri care trimit și tools sau response_format.

În afara rândului unui model

Un model open-weight găzduit refuză o imagine sau un mod JSON care nu se află pe rândul lui. Refuzul vine înainte să se scadă ceva din soldul tău:

Stare	Tip	Mesaj	Când
`400`	`invalid_request_error`	`<id> does not accept image input`	O imagine a fost trimisă unui model open-weight găzduit care nu acceptă imagini la intrare.
`400`	`invalid_request_error`	`<id> does not accept response_format`	S-a cerut ieșire JSON de la un model open-weight găzduit care nu are niciun mod JSON.
`400`	`invalid_request_error`	`<id> does not accept response_format json_schema; use json_object`	O schemă a fost trimisă unui model open-weight găzduit care are doar modul obiect JSON.

Un model Shannon răspunde la o astfel de cerere cu starea 200: capabilitatea din afara rândului lui nu participă la răspuns. Gestionare erori