Capacidades

Todos os modelos são acessados pelos mesmos três endpoints com a mesma chave. As duas tabelas mostram onde os modelos diferem. Um traço significa que o modelo responde sem esse recurso.

Modelos Shannon

Modelos open-weight hospedados

O id de um modelo hospedado é o seu nome e a sua variante unidos por um hífen, por exemplo DeepSeek-V4-Pro-0813-3BIT-REAP.

O que significa cada coluna

• Ferramentas. Você descreve funções em tools, o modelo responde com as chamadas que quer que sejam feitas e o seu código as executa. Todos os modelos aceitam ferramentas. Um tool_choice forçado é aplicado pelos modelos open-weight hospedados. Chamada de funções
• Entrada de imagem. O modelo lê imagens enviadas dentro de uma mensagem do usuário, como data URL ou como endereço. shannon-2-lite e shannon-2-pro leem imagens em requisições que também enviam tools ou response_format. A família Shannon 3 também lê documentos. Imagens e arquivos
• Raciocínio. A resposta pode trazer o texto de raciocínio do modelo ao lado da resposta, em um campo próprio. Esforço de raciocínio
• Esforço de raciocínio. Um campo da requisição define a profundidade do raciocínio do modelo: off, low, medium ou high. Os modelos Shannon definem a própria profundidade. Esforço de raciocínio
• Objeto JSON. Com response_format: {"type": "json_object"}, a resposta é JSON sem um formato prescrito. Em /v1/chat/completions e /v1/responses. Saídas estruturadas
• JSON schema. Com response_format do tipo json_schema, a resposta segue um schema que você envia. Em /v1/chat/completions e /v1/responses. Saídas estruturadas
• Cache de prompt. Um prompt que começa como um recente no mesmo modelo é lido do cache, e a parte em cache é cobrada a 25% do preço de entrada. Não precisa de nenhum campo na requisição. Caching de prompt
• Busca na web. Com web_search: true, a API pesquisa na web e entrega os resultados ao modelo antes de ele responder. Em /v1/chat/completions e /v1/messages. É um campo da requisição e não tem flag em GET /v1/models. Busca web integrada
• Streaming. Com stream: true, a resposta chega como server-sent events enquanto o modelo escreve. Todos os modelos fazem streaming nos três endpoints. Streaming

Os mesmos fatos em GET /v1/models

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

GET /v1/models lista todos os modelos com um objeto capabilities, para que um programa possa ler esses fatos em vez desta página. O endpoint não exige chave.

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 as capabilities de duas entradas de 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 são flags das entradas de modelos open-weight hospedados. Uma entrada Shannon informa a saída JSON apenas com json_schema, que vale para os dois modos JSON.
• vision é true para shannon-2-lite e shannon-2-pro: eles leem imagens em requisições que também enviam tools ou response_format.

Fora da linha de um modelo

Um modelo open-weight hospedado recusa uma imagem ou um modo JSON que está fora da sua linha. A recusa vem antes de qualquer desconto do seu saldo:

Um modelo Shannon responde a essa requisição com status 200: o recurso fora da sua linha não participa da resposta. Tratamento de erros