Registro de mudanças

Uma requisição com web_search: true nomeia suas fontes: sources em /v1/chat/completions e /v1/messages lista os resultados entregues ao modelo e, em /v1/chat/completions, annotations marca onde a resposta cita cada um deles. Busca web integrada

web_search: true em /v1/chat/completions e /v1/messages executa uma busca na web antes de o modelo responder e entrega a ele os resultados como fontes numeradas. Uma requisição que encontrou resultados usa uma busca da sua cota diária. Sem buscas restantes, a requisição é respondida sem busca. Busca web integrada

Um stream cortado no lado do servidor é cobrado pelo uso informado até aquele ponto. O restante da reserva volta ao seu saldo.

shannon-coder-1 responde em /v1/responses como nos outros dois endpoints. Ferramentas de código em CLI

Uma chave de API rotacionada deixa de funcionar imediatamente.

POST /v1/tokenize e POST /v1/messages/count_tokens: contagens de tokens gratuitas para os modelos open-weight hospedados. Contagem de tokens

Cache de prompt nos modelos open-weight hospedados. A entrada em cache é cobrada a 25% do preço de entrada e informada em usage nos três endpoints: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens e cache_read_input_tokens. GET /v1/models informa pricing.cached_input_per_million_usd e capabilities.prompt_caching para esses modelos. Caching de prompt

Modelos open-weight hospedados: um tool_choice forçado (required ou uma função nomeada) resulta em uma chamada de ferramenta. Chamada de funções

Os modelos open-weight hospedados aceitam uma mensagem system que não seja a primeira mensagem da conversa.

A API é acessível como um serviço onion do Tor e em um endereço I2P. As respostas de api.shannon-ai.com trazem os dois endereços nos headers Onion-Location e X-I2P-Location. Endpoints criptografados, Tor e I2P

Novos modelos shannon-3.1 e shannon-3.1-pro, listados por GET /v1/models. Modelos e preços

Uma requisição com streaming cujo cliente se desconecta é executada até o fim e é contabilizada. Antes, a resposta parava na desconexão.

As requisições a /v1/responses aparecem no registro de uso.

Os modelos open-weight hospedados aplicam os campos de amostragem: temperature, top_p, seed, stop e max_tokens em /v1/chat/completions; temperature, top_p e stop_sequences em /v1/messages; temperature, top_p e max_output_tokens em /v1/responses. Chat Completions

O registro de uso mostra um custo em USD para cada chamada e como total.

Um valor de model que não é um id publicado é respondido com 400, o tipo invalid_request_error e a mensagem unknown model: <id> nos três endpoints. Antes, essa requisição era respondida por shannon-1.6-lite. Modelos e preços

/v1 aceita apenas uma chave de API. Um cookie de login do site não é lido ali. Autenticação

Proteção contra flood: 120 requisições por minuto por conta nos três endpoints de geração. Limites e saldo

Quando o modelo não consegue responder, o erro traz a mensagem fixa The model backend failed to answer. Please retry. Uma verificação de saldo que não pode ser feita é respondida com 503 e o tipo api_error. Tratamento de erros

Uma requisição sem streaming que falha devolve a reserva ao seu saldo.

GET /v1/models informa capabilities.reasoning_effort para cada modelo. Esforço de raciocínio

Modelos open-weight hospedados: uma requisição sem streaming que não recebe resposta termina com 504 e o tipo api_error. Um resultado vazio é 502. Tratamento de erros

Os modelos open-weight hospedados aceitam a entrada que o modelo nomeado aceita. Uma imagem enviada a um id somente de texto é respondida com 400 e <id> does not accept image input. response_format em um id sem saída estruturada é respondido com 400. GET /v1/models informa capabilities.vision, response_format e json_schema para cada id. Imagens e arquivos

As respostas sem streaming trazem o texto de raciocínio: reasoning_content na mensagem de /v1/chat/completions e um bloco thinking antes do texto em /v1/messages. Esforço de raciocínio

Os modelos open-weight hospedados têm novos preços, a partir de $0.50 por 1M de tokens de entrada e $2.00 por 1M de tokens de saída. Modelos e preços

Os modelos open-weight hospedados têm um id por modelo, doze ids no total. Modelos e preços

Saída estruturada em shannon-3, shannon-3-pro, shannon-3.1 e shannon-3.1-pro. GET /v1/models informa capabilities.json_schema: true para eles. Saídas estruturadas

/v1/responses lê text.format (json_object ou json_schema) para a saída estruturada. API Responses

/v1/responses retorna o raciocínio dos modelos Shannon: um item de saída reasoning antes do item message, e os eventos de stream response.reasoning_summary_text.delta e response.reasoning_summary_text.done. API Responses

O campo model de uma resposta é o id publicado em todos os endpoints. Um objeto Responses traz model e created_at.

GET /v1/models informa a janela de contexto de cada modelo. Modelos e preços

Os modelos open-weight hospedados respondem em /v1/messages e /v1/responses, além de /v1/chat/completions, com o seu prompt de sistema e chamadas de ferramenta. /v1/messages aceita thinking, e reasoning_effort é um campo da requisição. Modelos e preços

Os corpos de erro em /v1 seguem os formatos dos SDKs: um objeto error com type e message nos endpoints no formato OpenAI, e o mesmo objeto dentro de {"type": "error"} em /v1/messages. Tratamento de erros

Keep-alive em streams abertos a cada 15 segundos: uma linha de comentário : ping em /v1/chat/completions e um event: ping em /v1/messages. Streaming

Os ids de chamada de ferramenta começam com call_ em /v1/chat/completions e /v1/responses, e com toolu_ em /v1/messages. Chamada de funções

/v1/responses: stream tem como padrão false. API Responses

max_completion_tokens é aceito como outro nome de max_tokens em /v1/chat/completions. Chat Completions

O evento response.completed de um stream de Responses traz o array output. API Responses

As entradas de GET /v1/models trazem display_name, context_window, max_output_tokens, pricing, capabilities e endpoints. Modelos e preços

Toda resposta traz x-request-id, e um valor que você envia é devolvido. Os corpos de requisição podem ter até 32 MiB.

Uma chave pode ser revogada sem que uma nova seja emitida. O registro de uso é paginado.

Imagens e documentos nas requisições: partes image_url em /v1/chat/completions, blocos image, document e file em /v1/messages, partes input_image em /v1/responses. Imagens e arquivos

Novo modelo shannon-3-pro. Modelos e preços

Novo modelo shannon-3. Modelos e preços

Streams em /v1/chat/completions trazem o raciocínio como delta.reasoning_content. Esforço de raciocínio

max_tokens é mantido entre 1 e 65,536. Um valor fora desse intervalo é levado ao extremo mais próximo, não recusado. Chat Completions

shannon-coder-1 é contado em chamadas por plano em /v1/chat/completions e /v1/messages. Quando as chamadas de uma janela se esgotam, a resposta é 429 com a mensagem Shannon Coder call quota reached. Ferramentas de código em CLI

Uma conversa maior que a janela de contexto é respondida com 400, o tipo invalid_request_error e o código context_length_exceeded. Um erro dentro de um stream chega como um evento de erro, não como texto na resposta. Ferramentas de código em CLI

Os endpoints /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses e GET /v1/models. São os endpoints que os SDKs da OpenAI e da Anthropic, o Claude Code e o Codex CLI chamam. Visão geral

Chamadas de ferramenta com tools em /v1/chat/completions e /v1/messages, saída estruturada com response_format e system como string ou como blocos de texto em /v1/messages. Chamada de funções

Ids de modelo shannon-1.6-pro, shannon-2-lite, shannon-2-pro e shannon-coder-1, ao lado de shannon-1.6-lite. Modelos e preços

Primeira versão da API: chat no formato OpenAI e no formato Anthropic, e um endpoint Responses, cada um chamado com uma chave de API que começa com sk-. Autenticação