Changelog

Eine Anfrage mit web_search: true nennt ihre Quellen: sources bei /v1/chat/completions und /v1/messages listet die Ergebnisse auf, die dem Modell gegeben wurden, und bei /v1/chat/completions markiert annotations, wo die Antwort jedes davon zitiert. Integrierte Websuche

web_search: true bei /v1/chat/completions und /v1/messages führt eine Websuche aus, bevor das Modell antwortet, und gibt ihm die Ergebnisse als nummerierte Quellen. Eine Anfrage, die Ergebnisse gefunden hat, verbraucht eine Suche Ihres Tageskontingents. Ist keine mehr übrig, wird die Anfrage ohne Suche beantwortet. Integrierte Websuche

Ein Stream, der serverseitig abgebrochen wird, wird für die bis dahin gemeldete Nutzung berechnet. Der Rest der Reservierung geht an Ihr Guthaben zurück.

shannon-coder-1 antwortet bei /v1/responses wie bei den beiden anderen Endpunkten. CLI-Coding-Tools

Ein rotierter API-Key funktioniert sofort nicht mehr.

POST /v1/tokenize und POST /v1/messages/count_tokens: kostenlose Token-Zählungen für die gehosteten Open-Weight-Modelle. Token zählen

Prompt-Caching bei den gehosteten Open-Weight-Modellen. Cached Input wird mit 25% des Input-Preises berechnet und in usage an allen drei Endpunkten gemeldet: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens und cache_read_input_tokens. GET /v1/models meldet für diese Modelle pricing.cached_input_per_million_usd und capabilities.prompt_caching. Prompt-Caching

Gehostete Open-Weight-Modelle: Ein erzwungenes tool_choice (required oder eine benannte Funktion) liefert einen Tool-Aufruf. Funktionsaufrufe

Gehostete Open-Weight-Modelle akzeptieren eine system-Nachricht, die nicht die erste Nachricht der Konversation ist.

Die API ist als Tor-Onion-Dienst und unter einer I2P-Adresse erreichbar. Antworten von api.shannon-ai.com enthalten die beiden Adressen in den Headern Onion-Location und X-I2P-Location. Verschlüsselte, Tor- und I2P-Endpunkte

Neue Modelle shannon-3.1 und shannon-3.1-pro, aufgeführt von GET /v1/models. Modelle & Preise

Eine gestreamte Anfrage, deren Client die Verbindung trennt, läuft bis zum Ende und wird gezählt. Zuvor brach die Antwort bei der Trennung ab.

Anfragen an /v1/responses erscheinen im Nutzungsprotokoll.

Gehostete Open-Weight-Modelle wenden die Sampling-Felder an: temperature, top_p, seed, stop und max_tokens bei /v1/chat/completions; temperature, top_p und stop_sequences bei /v1/messages; temperature, top_p und max_output_tokens bei /v1/responses. Chat Completions

Das Nutzungsprotokoll zeigt für jeden Aufruf und als Summe Kosten in USD.

Ein model-Wert, der keine veröffentlichte ID ist, wird bei allen drei Endpunkten mit 400, dem Typ invalid_request_error und der Nachricht unknown model: <id> beantwortet. Zuvor wurde eine solche Anfrage von shannon-1.6-lite beantwortet. Modelle & Preise

/v1 akzeptiert nur einen API-Key. Ein Anmelde-Cookie der Website wird dort nicht gelesen. Authentifizierung

Flood-Schutz: 120 Anfragen pro Minute und Konto an den drei Generierungs-Endpunkten. Limits und Guthaben

Wenn das Modell nicht antworten kann, enthält der Fehler die feste Nachricht The model backend failed to answer. Please retry. Eine Guthabenprüfung, die nicht durchgeführt werden kann, wird mit 503 und dem Typ api_error beantwortet. Fehlerbehandlung

Eine nicht gestreamte Anfrage, die fehlschlägt, gibt ihre Reservierung an Ihr Guthaben zurück.

GET /v1/models meldet für jedes Modell capabilities.reasoning_effort. Reasoning-Aufwand

Gehostete Open-Weight-Modelle: Eine nicht gestreamte Anfrage, die keine Antwort erhält, endet mit 504 und dem Typ api_error. Ein leeres Ergebnis ist 502. Fehlerbehandlung

Gehostete Open-Weight-Modelle nehmen den Input an, den das benannte Modell annimmt. Ein Bild, das an eine reine Text-ID gesendet wird, wird mit 400 und <id> does not accept image input beantwortet. response_format bei einer ID ohne strukturierte Ausgabe wird mit 400 beantwortet. GET /v1/models meldet für jede ID capabilities.vision, response_format und json_schema. Bilder und Dateien

Nicht gestreamte Antworten enthalten den Reasoning-Text: reasoning_content in der Nachricht bei /v1/chat/completions und einen thinking-Block vor dem Text bei /v1/messages. Reasoning-Aufwand

Gehostete Open-Weight-Modelle haben neue Preise, ab $0.50 pro 1M Input-Tokens und $2.00 pro 1M Output-Tokens. Modelle & Preise

Gehostete Open-Weight-Modelle haben eine ID pro Modell, insgesamt zwölf IDs. Modelle & Preise

Strukturierte Ausgabe bei shannon-3, shannon-3-pro, shannon-3.1 und shannon-3.1-pro. GET /v1/models meldet für sie capabilities.json_schema: true. Strukturierte Ausgaben

/v1/responses liest text.format (json_object oder json_schema) für strukturierte Ausgabe. Responses API

/v1/responses liefert das Reasoning der Shannon-Modelle: ein Output-Element reasoning vor dem Element message sowie die Stream-Events response.reasoning_summary_text.delta und response.reasoning_summary_text.done. Responses API

Das Feld model einer Antwort ist an jedem Endpunkt die veröffentlichte ID. Ein Responses-Objekt enthält model und created_at.

GET /v1/models meldet das Kontextfenster jedes Modells. Modelle & Preise

Gehostete Open-Weight-Modelle antworten bei /v1/messages und /v1/responses ebenso wie bei /v1/chat/completions, mit Ihrem System-Prompt und Tool-Aufrufen. /v1/messages nimmt thinking an, und reasoning_effort ist ein Anfragefeld. Modelle & Preise

Fehler-Bodys bei /v1 folgen den SDK-Formen: ein Objekt error mit type und message bei den Endpunkten im OpenAI-Format und dasselbe Objekt innerhalb von {"type": "error"} bei /v1/messages. Fehlerbehandlung

Keep-alive bei offenen Streams alle 15 Sekunden: eine Kommentarzeile : ping bei /v1/chat/completions, ein event: ping bei /v1/messages. Streaming

Tool-Aufruf-IDs beginnen bei /v1/chat/completions und /v1/responses mit call_ und bei /v1/messages mit toolu_. Funktionsaufrufe

/v1/responses: stream ist standardmäßig false. Responses API

max_completion_tokens wird bei /v1/chat/completions als anderer Name für max_tokens akzeptiert. Chat Completions

Das Event response.completed eines Responses-Streams enthält das Array output. Responses API

Einträge von GET /v1/models enthalten display_name, context_window, max_output_tokens, pricing, capabilities und endpoints. Modelle & Preise

Jede Antwort enthält x-request-id, und ein von Ihnen gesendeter Wert wird zurückgegeben. Request-Bodys dürfen bis zu 32 MiB groß sein.

Ein Key kann widerrufen werden, ohne dass ein neuer ausgestellt wird. Das Nutzungsprotokoll ist seitenweise abrufbar.

Bilder und Dokumente in Anfragen: image_url-Teile bei /v1/chat/completions, image-, document- und file-Blöcke bei /v1/messages, input_image-Teile bei /v1/responses. Bilder und Dateien

Neues Modell shannon-3-pro. Modelle & Preise

Neues Modell shannon-3. Modelle & Preise

Streams bei /v1/chat/completions tragen das Reasoning als delta.reasoning_content. Reasoning-Aufwand

max_tokens wird auf 1 bis 65,536 begrenzt. Ein Wert außerhalb dieses Bereichs wird auf das nächstliegende Ende gesetzt, nicht abgelehnt. Chat Completions

shannon-coder-1 wird bei /v1/chat/completions und /v1/messages in Aufrufen pro Plan gezählt. Sind die Aufrufe eines Fensters aufgebraucht, lautet die Antwort 429 mit der Nachricht Shannon Coder call quota reached. CLI-Coding-Tools

Eine Konversation, die größer als das Kontextfenster ist, wird mit 400, dem Typ invalid_request_error und dem Code context_length_exceeded beantwortet. Ein Fehler innerhalb eines Streams trifft als Fehler-Event ein, nicht als Text in der Antwort. CLI-Coding-Tools

Die /v1-Endpunkte: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses und GET /v1/models. Es sind die Endpunkte, die die OpenAI- und Anthropic-SDKs, Claude Code und Codex CLI aufrufen. Überblick

Tool-Aufrufe mit tools bei /v1/chat/completions und /v1/messages, strukturierte Ausgabe mit response_format und system als String oder als Textblöcke bei /v1/messages. Funktionsaufrufe

Modell-IDs shannon-1.6-pro, shannon-2-lite, shannon-2-pro und shannon-coder-1, neben shannon-1.6-lite. Modelle & Preise

Erste Version der API: Chat im OpenAI-Format und im Anthropic-Format sowie ein Responses-Endpunkt, jeweils aufgerufen mit einem API-Key, der mit sk- beginnt. Authentifizierung