Dziennik zmian

Zapytanie z web_search: true podaje swoje źródła: sources w /v1/chat/completions i /v1/messages wymienia wyniki przekazane modelowi, a w /v1/chat/completions annotations zaznacza, gdzie odpowiedź cytuje każdy z nich. Wbudowane wyszukiwanie w sieci

web_search: true w /v1/chat/completions i /v1/messages uruchamia wyszukiwanie w sieci, zanim model odpowie, i przekazuje mu wyniki jako ponumerowane źródła. Zapytanie, które znalazło wyniki, zużywa jedno wyszukiwanie z Twojego dziennego limitu. Gdy nic nie zostało, zapytanie dostaje odpowiedź bez wyszukiwania. Wbudowane wyszukiwanie w sieci

Strumień przerwany po stronie serwera jest rozliczany za użycie zaraportowane do tego momentu. Reszta rezerwacji wraca na Twoje saldo.

shannon-coder-1 odpowiada w /v1/responses tak samo jak w pozostałych dwóch endpointach. Narzędzia CLI do programowania

Zrotowany klucz API przestaje działać natychmiast.

POST /v1/tokenize i POST /v1/messages/count_tokens: darmowe liczenie tokenów dla hostowanych modeli open-weight. Liczenie tokenów

Prompt caching w hostowanych modelach open-weight. Wejście z cache jest rozliczane po 25% ceny wejścia i raportowane w usage we wszystkich trzech endpointach: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens i cache_read_input_tokens. GET /v1/models raportuje dla tych modeli pricing.cached_input_per_million_usd i capabilities.prompt_caching. Cache'owanie promptów

Hostowane modele open-weight: wymuszone tool_choice (required lub nazwana funkcja) daje wywołanie narzędzia. Wywołanie funkcji

Hostowane modele open-weight akceptują wiadomość system, która nie jest pierwszą wiadomością rozmowy.

API jest dostępne jako usługa onion w Tor i pod adresem I2P. Odpowiedzi api.shannon-ai.com niosą oba adresy w nagłówkach Onion-Location i X-I2P-Location. Szyfrowane endpointy, Tor i I2P

Nowe modele shannon-3.1 i shannon-3.1-pro, wymienione przez GET /v1/models. Modele i ceny

Zapytanie w streamingu, którego klient się rozłączy, jest wykonywane do końca i liczone. Wcześniej odpowiedź zatrzymywała się przy rozłączeniu.

Zapytania do /v1/responses pojawiają się w dzienniku użycia.

Hostowane modele open-weight stosują pola próbkowania: temperature, top_p, seed, stop i max_tokens w /v1/chat/completions; temperature, top_p i stop_sequences w /v1/messages; temperature, top_p i max_output_tokens w /v1/responses. Chat Completions

Dziennik użycia pokazuje koszt w USD dla każdego wywołania oraz jako sumę.

Wartość model, która nie jest opublikowanym id, dostaje odpowiedź 400, typ invalid_request_error i komunikat unknown model: <id> we wszystkich trzech endpointach. Wcześniej na takie zapytanie odpowiadał shannon-1.6-lite. Modele i ceny

/v1 przyjmuje wyłącznie klucz API. Cookie logowania ze strony internetowej nie jest tam odczytywane. Uwierzytelnianie

Ochrona przed floodem: 120 zapytań na minutę na konto w trzech endpointach generowania. Limity i saldo

Gdy model nie może odpowiedzieć, błąd niesie stały komunikat The model backend failed to answer. Please retry. Sprawdzenie salda, którego nie da się wykonać, dostaje odpowiedź 503 i typ api_error. Obsługa błędów

Zapytanie bez streamingu, które się nie powiedzie, zwraca swoją rezerwację na Twoje saldo.

GET /v1/models raportuje capabilities.reasoning_effort dla każdego modelu. Wysiłek rozumowania

Hostowane modele open-weight: zapytanie bez streamingu, które nie dostaje odpowiedzi, kończy się 504 i typem api_error. Pusty wynik to 502. Obsługa błędów

Hostowane modele open-weight przyjmują to wejście, które przyjmuje wskazany model. Obraz wysłany do id tylko tekstowego dostaje odpowiedź 400 i <id> does not accept image input. response_format w id bez wyjścia strukturyzowanego dostaje odpowiedź 400. GET /v1/models raportuje capabilities.vision, response_format i json_schema dla każdego id. Obrazy i pliki

Odpowiedzi bez streamingu niosą tekst wnioskowania: reasoning_content w wiadomości /v1/chat/completions oraz blok thinking przed tekstem w /v1/messages. Wysiłek rozumowania

Hostowane modele open-weight mają nowe ceny, od $0.50 za 1M tokenów wejściowych i $2.00 za 1M tokenów wyjściowych. Modele i ceny

Hostowane modele open-weight mają po jednym id na model, razem dwanaście id. Modele i ceny

Wyjście strukturyzowane w shannon-3, shannon-3-pro, shannon-3.1 i shannon-3.1-pro. GET /v1/models raportuje dla nich capabilities.json_schema: true. Ustrukturyzowane odpowiedzi

/v1/responses czyta text.format (json_object lub json_schema) dla wyjścia strukturyzowanego. Responses API

/v1/responses zwraca wnioskowanie modeli Shannon: element wyjścia reasoning przed elementem message oraz zdarzenia strumienia response.reasoning_summary_text.delta i response.reasoning_summary_text.done. Responses API

Pole model odpowiedzi jest opublikowanym id w każdym endpoincie. Obiekt Responses niesie model i created_at.

GET /v1/models raportuje okno kontekstu każdego modelu. Modele i ceny

Hostowane modele open-weight odpowiadają w /v1/messages i /v1/responses, tak jak w /v1/chat/completions, z Twoim promptem systemowym i wywołaniami narzędzi. /v1/messages przyjmuje thinking, a reasoning_effort jest polem zapytania. Modele i ceny

Treści błędów w /v1 mają kształty znane z SDK: obiekt error z type i message w endpointach w formacie OpenAI oraz ten sam obiekt wewnątrz {"type": "error"} w /v1/messages. Obsługa błędów

Keep-alive w otwartych strumieniach co 15 sekund: linia komentarza : ping w /v1/chat/completions, event: ping w /v1/messages. Streaming

Id wywołań narzędzi zaczynają się od call_ w /v1/chat/completions i /v1/responses oraz od toolu_ w /v1/messages. Wywołanie funkcji

/v1/responses: stream domyślnie ma wartość false. Responses API

max_completion_tokens jest akceptowane jako inna nazwa max_tokens w /v1/chat/completions. Chat Completions

Zdarzenie response.completed strumienia Responses niesie tablicę output. Responses API

Pozycje GET /v1/models niosą display_name, context_window, max_output_tokens, pricing, capabilities i endpoints. Modele i ceny

Każda odpowiedź niesie x-request-id, a wartość, którą wyślesz, jest zwracana. Treść zapytania może mieć do 32 MiB.

Klucz można unieważnić bez wydawania nowego. Dziennik użycia jest stronicowany.

Obrazy i dokumenty w zapytaniach: części image_url w /v1/chat/completions, bloki image, document i file w /v1/messages, części input_image w /v1/responses. Obrazy i pliki

Nowy model shannon-3-pro. Modele i ceny

Nowy model shannon-3. Modele i ceny

Strumienie w /v1/chat/completions niosą wnioskowanie jako delta.reasoning_content. Wysiłek rozumowania

max_tokens jest utrzymywane w zakresie od 1 do 65,536. Wartość spoza tego zakresu jest sprowadzana do najbliższego końca, a nie odrzucana. Chat Completions

shannon-coder-1 jest liczony w wywołaniach na plan w /v1/chat/completions i /v1/messages. Gdy wywołania okna się wyczerpią, odpowiedzią jest 429 z komunikatem Shannon Coder call quota reached. Narzędzia CLI do programowania

Na rozmowę większą niż okno kontekstu odpowiedzią jest 400, typ invalid_request_error i kod context_length_exceeded. Błąd wewnątrz strumienia przychodzi jako zdarzenie błędu, a nie jako tekst w odpowiedzi. Narzędzia CLI do programowania

Endpointy /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses i GET /v1/models. Są to endpointy, które wywołują SDK OpenAI i Anthropic, Claude Code i Codex CLI. Przegląd

Wywołania narzędzi z tools w /v1/chat/completions i /v1/messages, wyjście strukturyzowane z response_format oraz system jako ciąg znaków lub bloki tekstowe w /v1/messages. Wywołanie funkcji

Id modeli shannon-1.6-pro, shannon-2-lite, shannon-2-pro i shannon-coder-1, obok shannon-1.6-lite. Modele i ceny

Pierwsze wydanie API: czat w formacie OpenAI i w formacie Anthropic oraz endpoint Responses, każdy wywoływany kluczem API zaczynającym się od sk-. Uwierzytelnianie