Rexistro de cambios

Unha solicitude con web_search: true nomea as súas fontes: sources en /v1/chat/completions e /v1/messages lista os resultados que recibiu o modelo, e en /v1/chat/completions annotations marca onde cita a resposta cada un. Busca web

web_search: true en /v1/chat/completions e /v1/messages executa unha busca web antes de que o modelo responda e dálle os resultados como fontes numeradas. Unha solicitude que atopou resultados usa unha busca da túa cota diaria. Se non queda ningunha, a solicitude respóndese sen busca. Busca web

Un stream cortado polo lado do servidor factúrase polo uso informado ata ese momento. O resto da reserva volve ao teu saldo.

shannon-coder-1 responde en /v1/responses como fai nos outros dous endpoints. Ferramentas de código CLI

Unha clave API rotada deixa de funcionar de inmediato.

POST /v1/tokenize e POST /v1/messages/count_tokens: reconto gratuíto de tokens para os modelos open-weight alojados. Reconto de tokens

Caché de prompts nos modelos open-weight alojados. A entrada en caché factúrase ao 25% do prezo de entrada e infórmase en usage nos tres 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 estes modelos. Caché de prompts

Modelos open-weight alojados: un tool_choice forzado (required ou unha función nomeada) produce unha chamada a unha ferramenta. Chamadas a funcións

Os modelos open-weight alojados aceptan unha mensaxe system que non é a primeira mensaxe da conversa.

A API é accesible como servizo onion de Tor e nun enderezo I2P. As respostas de api.shannon-ai.com levan os dous enderezos nas cabeceiras Onion-Location e X-I2P-Location. Endpoints cifrados, Tor e I2P

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

Unha solicitude con stream cuxo cliente se desconecta execútase ata o final e cóntase. Antes, a resposta detíñase coa desconexión.

As solicitudes a /v1/responses aparecen no rexistro de uso.

Os modelos open-weight alojados aplican os campos de mostraxe: temperature, top_p, seed, stop e max_tokens en /v1/chat/completions; temperature, top_p e stop_sequences en /v1/messages; temperature, top_p e max_output_tokens en /v1/responses. Chat Completions

O rexistro de uso mostra un custo en USD para cada chamada e como total.

Un valor de model que non é un id publicado recibe 400, o tipo invalid_request_error e a mensaxe unknown model: <id> nos tres endpoints. Antes, esa solicitude respondíaa shannon-1.6-lite. Modelos e prezos

/v1 só acepta unha clave API. Unha cookie de inicio de sesión do sitio web non se le alí. Autenticación

Protección contra inundación: 120 solicitudes por minuto e conta nos tres endpoints de xeración. Límites e saldo

Cando o modelo non pode responder, o erro leva a mensaxe fixa The model backend failed to answer. Please retry. Unha comprobación de saldo que non se pode facer recibe 503 e o tipo api_error. Xestión de erros

Unha solicitude sen stream que falla devolve a súa reserva ao teu saldo.

GET /v1/models informa capabilities.reasoning_effort para cada modelo. Esforzo de razoamento

Modelos open-weight alojados: unha solicitude sen stream que non recibe resposta remata con 504 e o tipo api_error. Un resultado baleiro é 502. Xestión de erros

Os modelos open-weight alojados aceptan a entrada que acepta o modelo nomeado. Unha imaxe enviada a un id só de texto recibe como resposta 400 e <id> does not accept image input. response_format nun id sen saída estruturada recibe 400. GET /v1/models informa capabilities.vision, response_format e json_schema para cada id. Imaxes e ficheiros

As respostas sen stream levan o texto de razoamento: reasoning_content na mensaxe de /v1/chat/completions e un bloque thinking antes do texto en /v1/messages. Esforzo de razoamento

Os modelos open-weight alojados teñen prezos novos, desde $0.50 por 1M de tokens de entrada e $2.00 por 1M de tokens de saída. Modelos e prezos

Os modelos open-weight alojados teñen un id por modelo, doce ids en total. Modelos e prezos

Saída estruturada en 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 le text.format (json_object ou json_schema) para a saída estruturada. API Responses

/v1/responses devolve o razoamento dos modelos Shannon: un elemento de saída reasoning antes do elemento message e os eventos de stream response.reasoning_summary_text.delta e response.reasoning_summary_text.done. API Responses

O campo model dunha resposta é o id publicado en todos os endpoints. Un obxecto de Responses leva model e created_at.

GET /v1/models informa da ventá de contexto de cada modelo. Modelos e prezos

Os modelos open-weight alojados responden en /v1/messages e /v1/responses ademais de en /v1/chat/completions, co teu system prompt e chamadas a ferramentas. /v1/messages acepta thinking, e reasoning_effort é un campo da solicitude. Modelos e prezos

Os corpos de erro en /v1 seguen as formas dos SDK: un obxecto error con type e message nos endpoints en formato OpenAI, e o mesmo obxecto dentro de {"type": "error"} en /v1/messages. Xestión de erros

Keep-alive nos streams abertos cada 15 segundos: unha liña de comentario : ping en /v1/chat/completions e un event: ping en /v1/messages. Streaming

Os ids das chamadas a ferramentas comezan por call_ en /v1/chat/completions e /v1/responses, e por toolu_ en /v1/messages. Chamadas a funcións

/v1/responses: stream ten como valor predeterminado false. API Responses

max_completion_tokens acéptase como outro nome para max_tokens en /v1/chat/completions. Chat Completions

O evento response.completed dun stream de Responses leva a matriz output. API Responses

As entradas de GET /v1/models levan display_name, context_window, max_output_tokens, pricing, capabilities e endpoints. Modelos e prezos

Todas as respostas levan x-request-id, e devólvese o valor que envíes. Os corpos das solicitudes poden ter ata 32 MiB.

Unha clave pode revogarse sen que se emita unha nova. O rexistro de uso está paxinado.

Imaxes e documentos nas solicitudes: partes image_url en /v1/chat/completions, bloques image, document e file en /v1/messages, partes input_image en /v1/responses. Imaxes e ficheiros

Novo modelo shannon-3-pro. Modelos e prezos

Novo modelo shannon-3. Modelos e prezos

Os streams en /v1/chat/completions levan o razoamento como delta.reasoning_content. Esforzo de razoamento

max_tokens mantense entre 1 e 65,536. Un valor fóra dese intervalo axústase ao extremo máis próximo, non se rexeita. Chat Completions

shannon-coder-1 cóntase en chamadas por plan en /v1/chat/completions e /v1/messages. Cando se esgotan as chamadas dunha xanela, a resposta é 429 coa mensaxe Shannon Coder call quota reached. Ferramentas de código CLI

Unha conversa máis grande que a ventá de contexto recibe como resposta 400, o tipo invalid_request_error e o código context_length_exceeded. Un erro dentro dun stream chega como evento de erro, non como texto na resposta. Ferramentas de código CLI

Os endpoints /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses e GET /v1/models. Son os endpoints aos que chaman os SDK de OpenAI e Anthropic, Claude Code e Codex CLI. Visión xeral

Chamadas a ferramentas con tools en /v1/chat/completions e /v1/messages, saída estruturada con response_format e system como cadea ou como bloques de texto en /v1/messages. Chamadas a funcións

Ids de modelo shannon-1.6-pro, shannon-2-lite, shannon-2-pro e shannon-coder-1, xunto a shannon-1.6-lite. Modelos e prezos

Primeira versión da API: chat no formato de OpenAI e no formato de Anthropic, e un endpoint Responses, cada un chamado cunha clave API que comeza por sk-. Autenticación