Registro modifiche

Una richiesta con web_search: true nomina le sue fonti: sources su /v1/chat/completions e /v1/messages elenca i risultati dati al modello e, su /v1/chat/completions, annotations segna dove la risposta cita ciascuno di essi. Ricerca web integrata

web_search: true su /v1/chat/completions e /v1/messages esegue una ricerca web prima che il modello risponda e gli passa i risultati come fonti numerate. Una richiesta che ha trovato risultati usa una ricerca della tua quota giornaliera. Se non ne restano, la richiesta riceve risposta senza ricerca. Ricerca web integrata

Uno stream interrotto lato server viene fatturato per l'utilizzo riportato fino a quel punto. Il resto della riserva torna al tuo saldo.

shannon-coder-1 risponde su /v1/responses come sugli altri due endpoint. Strumenti CLI per la programmazione

Una chiave API ruotata smette di funzionare subito.

POST /v1/tokenize e POST /v1/messages/count_tokens: conteggi gratuiti dei token per i modelli open-weight ospitati. Conteggio dei token

Prompt caching sui modelli open-weight ospitati. L'input cached è fatturato al 25% del prezzo dell'input e riportato in usage su tutti e tre gli endpoint: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens e cache_read_input_tokens. GET /v1/models riporta pricing.cached_input_per_million_usd e capabilities.prompt_caching per questi modelli. Prompt caching

Modelli open-weight ospitati: un tool_choice forzato (required o una funzione indicata per nome) produce una chiamata a tool. Chiamata di funzioni

I modelli open-weight ospitati accettano un messaggio system che non è il primo messaggio della conversazione.

L'API è raggiungibile come servizio onion di Tor e a un indirizzo I2P. Le risposte di api.shannon-ai.com portano i due indirizzi negli header Onion-Location e X-I2P-Location. Endpoint cifrati, Tor e I2P

Nuovi modelli shannon-3.1 e shannon-3.1-pro, elencati da GET /v1/models. Modelli e prezzi

Una richiesta in streaming il cui client si disconnette viene eseguita fino alla fine e conteggiata. Prima, la risposta si fermava alla disconnessione.

Le richieste a /v1/responses compaiono nel registro di utilizzo.

I modelli open-weight ospitati applicano i campi di campionamento: temperature, top_p, seed, stop e max_tokens su /v1/chat/completions; temperature, top_p e stop_sequences su /v1/messages; temperature, top_p e max_output_tokens su /v1/responses. Chat Completions

Il registro di utilizzo mostra un costo in USD per ogni chiamata e come totale.

Un valore di model che non è un id pubblicato riceve come risposta 400, il tipo invalid_request_error e il messaggio unknown model: <id> su tutti e tre gli endpoint. Prima, una richiesta del genere riceveva risposta da shannon-1.6-lite. Modelli e prezzi

/v1 accetta solo una chiave API. Un cookie di accesso del sito web non viene letto lì. Autenticazione

Flood protection: 120 richieste al minuto per account sui tre endpoint di generazione. Limiti e saldo

Quando il modello non può rispondere, l'errore porta il messaggio fisso The model backend failed to answer. Please retry. Un controllo del saldo che non può essere eseguito riceve come risposta 503 e il tipo api_error. Gestione errori

Una richiesta non in streaming che fallisce restituisce la sua riserva al tuo saldo.

GET /v1/models riporta capabilities.reasoning_effort per ogni modello. Sforzo di ragionamento

Modelli open-weight ospitati: una richiesta non in streaming che non riceve risposta termina con 504 e il tipo api_error. Un risultato vuoto è 502. Gestione errori

I modelli open-weight ospitati accettano l'input che accetta il modello indicato. Un'immagine inviata a un id di solo testo riceve come risposta 400 e <id> does not accept image input. response_format su un id senza output strutturato riceve come risposta 400. GET /v1/models riporta capabilities.vision, response_format e json_schema per ogni id. Immagini e file

Le risposte non in streaming portano il testo del ragionamento: reasoning_content nel messaggio di /v1/chat/completions, e un blocco thinking prima del testo su /v1/messages. Sforzo di ragionamento

I modelli open-weight ospitati hanno nuovi prezzi, a partire da $0.50 per 1M di token di input e $2.00 per 1M di token di output. Modelli e prezzi

I modelli open-weight ospitati hanno un id per modello, dodici id in tutto. Modelli e prezzi

Output strutturato su shannon-3, shannon-3-pro, shannon-3.1 e shannon-3.1-pro. GET /v1/models riporta per loro capabilities.json_schema: true. Output strutturati

/v1/responses legge text.format (json_object o json_schema) per l'output strutturato. Responses API

/v1/responses restituisce il ragionamento dei modelli Shannon: un elemento di output reasoning prima dell'elemento message, e gli eventi di stream response.reasoning_summary_text.delta e response.reasoning_summary_text.done. Responses API

Il campo model di una risposta è l'id pubblicato su ogni endpoint. Un oggetto Responses porta model e created_at.

GET /v1/models riporta la finestra di contesto di ogni modello. Modelli e prezzi

I modelli open-weight ospitati rispondono anche su /v1/messages e /v1/responses, oltre che su /v1/chat/completions, con il tuo system prompt e le chiamate a tool. /v1/messages accetta thinking, e reasoning_effort è un campo della richiesta. Modelli e prezzi

I corpi di errore su /v1 seguono le forme degli SDK: un oggetto error con type e message sugli endpoint nel formato OpenAI, e lo stesso oggetto dentro {"type": "error"} su /v1/messages. Gestione errori

Keep-alive sugli stream aperti ogni 15 secondi: una riga di commento : ping su /v1/chat/completions, un event: ping su /v1/messages. Streaming

Gli id delle chiamate a tool iniziano con call_ su /v1/chat/completions e /v1/responses, e con toolu_ su /v1/messages. Chiamata di funzioni

/v1/responses: stream ha come default false. Responses API

max_completion_tokens è accettato come altro nome di max_tokens su /v1/chat/completions. Chat Completions

L'evento response.completed di uno stream Responses porta l'array output. Responses API

Le voci di GET /v1/models portano display_name, context_window, max_output_tokens, pricing, capabilities e endpoints. Modelli e prezzi

Ogni risposta porta x-request-id, e un valore che invii viene restituito. I corpi delle richieste possono arrivare a 32 MiB.

Una chiave può essere revocata senza che ne venga emessa una nuova. Il registro di utilizzo è paginato.

Immagini e documenti nelle richieste: parti image_url su /v1/chat/completions, blocchi image, document e file su /v1/messages, parti input_image su /v1/responses. Immagini e file

Nuovo modello shannon-3-pro. Modelli e prezzi

Nuovo modello shannon-3. Modelli e prezzi

Gli stream su /v1/chat/completions portano il ragionamento come delta.reasoning_content. Sforzo di ragionamento

max_tokens è mantenuto tra 1 e 65,536. Un valore fuori da questo intervallo viene portato all'estremo più vicino, non rifiutato. Chat Completions

shannon-coder-1 è conteggiato in chiamate per piano su /v1/chat/completions e /v1/messages. Quando le chiamate di una finestra sono esaurite, la risposta è 429 con il messaggio Shannon Coder call quota reached. Strumenti CLI per la programmazione

Una conversazione più grande della finestra di contesto riceve come risposta 400, il tipo invalid_request_error e il codice context_length_exceeded. Un errore all'interno di uno stream arriva come evento di errore, non come testo nella risposta. Strumenti CLI per la programmazione

Gli endpoint /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses e GET /v1/models. Sono gli endpoint che chiamano gli SDK OpenAI e Anthropic, Claude Code e Codex CLI. Panoramica

Chiamate a tool con tools su /v1/chat/completions e /v1/messages, output strutturato con response_format, e system come stringa o come blocchi di testo su /v1/messages. Chiamata di funzioni

Id di modello shannon-1.6-pro, shannon-2-lite, shannon-2-pro e shannon-coder-1, accanto a shannon-1.6-lite. Modelli e prezzi

Prima release dell'API: chat nel formato OpenAI e nel formato Anthropic, e un endpoint Responses, ciascuno chiamato con una chiave API che inizia con sk-. Autenticazione