Registre de canvis

Una sol·licitud amb web_search: true anomena les seves fonts: sources a /v1/chat/completions i /v1/messages llista els resultats que s'han donat al model, i a /v1/chat/completions annotations marca on la resposta cita cadascun. Cerca web

web_search: true a /v1/chat/completions i /v1/messages executa una cerca web abans que el model respongui i li dona els resultats com a fonts numerades. Una sol·licitud que ha trobat resultats gasta una cerca de la teva quota diària. Si no en queda cap, la sol·licitud es respon sense cerca. Cerca web

Un stream que es talla al costat del servidor es factura per l'ús informat fins a aquest punt. La resta de la reserva torna al teu saldo.

shannon-coder-1 respon a /v1/responses igual que als altres dos endpoints. Eines de programació CLI

Una clau API de la qual s'ha fet la rotació deixa de funcionar a l'instant.

POST /v1/tokenize i POST /v1/messages/count_tokens: recomptes de tokens gratuïts per als models open-weight hostejats. Recompte de tokens

Prompt caching als models open-weight hostejats. L'entrada en cache es factura al 25% del preu d'entrada i s'informa a usage als tres endpoints: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens i cache_read_input_tokens. GET /v1/models informa pricing.cached_input_per_million_usd i capabilities.prompt_caching per a aquests models. Caching de prompts

Models open-weight hostejats: un tool_choice forçat (required o una funció amb nom) produeix una crida d'eina. Crida de funcions

Els models open-weight hostejats accepten un missatge system que no és el primer missatge de la conversa.

L'API és accessible com a servei onion de Tor i en una adreça d'I2P. Les respostes d'api.shannon-ai.com porten les dues adreces a les capçaleres Onion-Location i X-I2P-Location. Endpoints xifrats, Tor i I2P

Models nous shannon-3.1 i shannon-3.1-pro, llistats per GET /v1/models. Models i preus

Una sol·licitud amb stream el client de la qual es desconnecta s'executa fins al final i es compta. Abans, la resposta s'aturava en la desconnexió.

Les sol·licituds a /v1/responses apareixen al registre d'ús.

Els models open-weight hostejats apliquen els camps de mostreig: temperature, top_p, seed, stop i max_tokens a /v1/chat/completions; temperature, top_p i stop_sequences a /v1/messages; temperature, top_p i max_output_tokens a /v1/responses. Chat Completions

El registre d'ús mostra un cost en USD per a cada crida i com a total.

Un valor de model que no és un id publicat es respon amb 400, el tipus invalid_request_error i el missatge unknown model: <id> als tres endpoints. Abans, una sol·licitud així la responia shannon-1.6-lite. Models i preus

/v1 només accepta una clau API. Una cookie d'inici de sessió del lloc web no s'hi llegeix. Autenticació

Protecció contra inundació: 120 sol·licituds per minut per compte als tres endpoints de generació. Límits i saldo

Quan el model no pot respondre, l'error porta el missatge fix The model backend failed to answer. Please retry. Una comprovació de saldo que no es pot fer es respon amb 503 i el tipus api_error. Gestió d’errors

Una sol·licitud sense stream que falla retorna la seva reserva al teu saldo.

GET /v1/models informa capabilities.reasoning_effort per a cada model. Esforç de raonament

Models open-weight hostejats: una sol·licitud sense stream que no rep resposta acaba amb 504 i el tipus api_error. Un resultat buit és 502. Gestió d’errors

Els models open-weight hostejats accepten l'entrada que accepta el model amb aquest nom. Una imatge enviada a un id només de text es respon amb 400 i <id> does not accept image input. response_format en un id sense sortida estructurada es respon amb 400. GET /v1/models informa capabilities.vision, response_format i json_schema per a cada id. Imatges i fitxers

Les respostes sense stream porten el text de raonament: reasoning_content al missatge de /v1/chat/completions, i un bloc thinking abans del text a /v1/messages. Esforç de raonament

Els models open-weight hostejats tenen preus nous, des de $0.50 per 1M de tokens d'entrada i $2.00 per 1M de tokens de sortida. Models i preus

Els models open-weight hostejats tenen un id per model, dotze ids en total. Models i preus

Sortida estructurada a shannon-3, shannon-3-pro, shannon-3.1 i shannon-3.1-pro. GET /v1/models informa capabilities.json_schema: true per a ells. Sortides estructurades

/v1/responses llegeix text.format (json_object o json_schema) per a la sortida estructurada. API Responses

/v1/responses retorna el raonament dels models Shannon: un element de sortida reasoning abans de l'element message, i els esdeveniments de stream response.reasoning_summary_text.delta i response.reasoning_summary_text.done. API Responses

El camp model d'una resposta és l'id publicat a tots els endpoints. Un objecte Responses porta model i created_at.

GET /v1/models informa de la finestra de context de cada model. Models i preus

Els models open-weight hostejats responen a /v1/messages i /v1/responses així com a /v1/chat/completions, amb el teu prompt de sistema i les crides d'eina. /v1/messages accepta thinking, i reasoning_effort és un camp de la sol·licitud. Models i preus

Els cossos d'error a /v1 segueixen les formes dels SDK: un objecte error amb type i message als endpoints en format OpenAI, i el mateix objecte dins de {"type": "error"} a /v1/messages. Gestió d’errors

Keep-alive als streams oberts cada 15 segons: una línia de comentari : ping a /v1/chat/completions, un event: ping a /v1/messages. Streaming

Els ids de crida d'eina comencen per call_ a /v1/chat/completions i /v1/responses, i per toolu_ a /v1/messages. Crida de funcions

/v1/responses: stream per defecte és false. API Responses

max_completion_tokens s'accepta com a altre nom de max_tokens a /v1/chat/completions. Chat Completions

L'esdeveniment response.completed d'un stream de Responses porta la matriu output. API Responses

Les entrades de GET /v1/models porten display_name, context_window, max_output_tokens, pricing, capabilities i endpoints. Models i preus

Cada resposta porta x-request-id, i un valor que enviïs es retorna. Els cossos de sol·licitud poden arribar a 32 MiB.

Una clau es pot revocar sense que se'n generi una de nova. El registre d'ús és paginat.

Imatges i documents en sol·licituds: parts image_url a /v1/chat/completions, blocs image, document i file a /v1/messages, parts input_image a /v1/responses. Imatges i fitxers

Model nou shannon-3-pro. Models i preus

Model nou shannon-3. Models i preus

Els streams a /v1/chat/completions porten el raonament com a delta.reasoning_content. Esforç de raonament

max_tokens es manté entre 1 i 65,536. Un valor fora d'aquest interval es porta a l'extrem més proper, no es rebutja. Chat Completions

shannon-coder-1 es compta en crides per pla a /v1/chat/completions i /v1/messages. Quan s'esgoten les crides d'una finestra, la resposta és 429 amb el missatge Shannon Coder call quota reached. Eines de programació CLI

Una conversa més gran que la finestra de context es respon amb 400, el tipus invalid_request_error i el codi context_length_exceeded. Un error dins d'un stream arriba com a esdeveniment d'error, no com a text a la resposta. Eines de programació CLI

Els endpoints /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses i GET /v1/models. Són els endpoints que criden els SDK d'OpenAI i d'Anthropic, Claude Code i Codex CLI. Visió general

Crides d'eina amb tools a /v1/chat/completions i /v1/messages, sortida estructurada amb response_format, i system com a cadena o com a blocs de text a /v1/messages. Crida de funcions

Ids de model shannon-1.6-pro, shannon-2-lite, shannon-2-pro i shannon-coder-1, al costat de shannon-1.6-lite. Models i preus

Primera versió de l'API: xat en el format d'OpenAI i en el format d'Anthropic, i un endpoint Responses, cadascun cridat amb una clau API que comença per sk-. Autenticació