Přehled změn

Požadavek s web_search: true jmenuje své zdroje: sources na /v1/chat/completions a /v1/messages uvádí výsledky, které model dostal, a na /v1/chat/completions annotations označuje, kde odpověď každý z nich cituje. Vestavěné webové vyhledávání

web_search: true na /v1/chat/completions a /v1/messages provede vyhledávání na webu dřív, než model odpoví, a předá mu výsledky jako číslované zdroje. Požadavek, který našel výsledky, spotřebuje jedno vyhledávání z vašeho denního limitu. Když žádné nezbývá, odpoví se bez vyhledávání. Vestavěné webové vyhledávání

Stream přerušený na straně serveru se účtuje podle využití hlášeného do tohoto okamžiku. Zbytek rezervace se vrátí na váš zůstatek.

shannon-coder-1 odpovídá na /v1/responses stejně jako na ostatních dvou endpointech. CLI nástroje pro programování

Rotovaný API klíč přestane fungovat okamžitě.

POST /v1/tokenize a POST /v1/messages/count_tokens: bezplatné počítání tokenů pro hostované modely s otevřenými váhami. Počítání tokenů

Caching promptů u hostovaných modelů s otevřenými váhami. Cachovaný vstup se účtuje za 25 % ceny vstupu a hlásí se v usage na všech třech endpointech: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens a cache_read_input_tokens. GET /v1/models pro tyto modely hlásí pricing.cached_input_per_million_usd a capabilities.prompt_caching. Caching promptů

Hostované modely s otevřenými váhami: vynucený tool_choice (required nebo pojmenovaná funkce) vede k volání nástroje. Volání funkcí

Hostované modely s otevřenými váhami přijímají zprávu system, která není první zprávou konverzace.

API je dostupné jako onion služba Tor a na adrese I2P. Odpovědi z api.shannon-ai.com nesou obě adresy v hlavičkách Onion-Location a X-I2P-Location. Šifrované endpointy, Tor a I2P

Nové modely shannon-3.1 a shannon-3.1-pro, uvedené v GET /v1/models. Modely a ceny

Streamovaný požadavek, jehož klient se odpojí, doběhne do konce a započítá se. Dříve se odpověď při odpojení zastavila.

Požadavky na /v1/responses se objevují v záznamu využití.

Hostované modely s otevřenými váhami uplatňují pole vzorkování: temperature, top_p, seed, stop a max_tokens na /v1/chat/completions; temperature, top_p a stop_sequences na /v1/messages; temperature, top_p a max_output_tokens na /v1/responses. Chat Completions

Záznam využití ukazuje cenu v USD u každého volání i jako součet.

Na hodnotu model, která není zveřejněným id, se na všech třech endpointech odpovídá 400, typem invalid_request_error a zprávou unknown model: <id>. Dříve na takový požadavek odpovídal shannon-1.6-lite. Modely a ceny

/v1 přijímá pouze API klíč. Přihlašovací cookie webu se tam nečte. Ověření

Ochrana proti zahlcení: 120 požadavků za minutu na účet na třech generačních endpointech. Limity a zůstatek

Když model nemůže odpovědět, chyba nese pevnou zprávu The model backend failed to answer. Please retry. Na kontrolu zůstatku, kterou nelze provést, se odpovídá 503 a typem api_error. Zpracování chyb

Nestreamovaný požadavek, který selže, vrátí svou rezervaci na váš zůstatek.

GET /v1/models hlásí capabilities.reasoning_effort pro každý model. Úsilí uvažování

Hostované modely s otevřenými váhami: nestreamovaný požadavek, který nedostane odpověď, skončí s 504 a typem api_error. Prázdný výsledek je 502. Zpracování chyb

Hostované modely s otevřenými váhami přijímají vstup, který přijímá pojmenovaný model. Na obrázek poslaný id pouze pro text se odpovídá 400 a <id> does not accept image input. Na response_format u id bez strukturovaného výstupu se odpovídá 400. GET /v1/models hlásí capabilities.vision, response_format a json_schema pro každé id. Obrázky a soubory

Nestreamované odpovědi nesou text uvažování: reasoning_content ve zprávě na /v1/chat/completions a blok thinking před textem na /v1/messages. Úsilí uvažování

Hostované modely s otevřenými váhami mají nové ceny, od $0.50 za 1M vstupních tokenů a $2.00 za 1M výstupních tokenů. Modely a ceny

Hostované modely s otevřenými váhami mají jedno id na model, celkem dvanáct id. Modely a ceny

Strukturovaný výstup na shannon-3, shannon-3-pro, shannon-3.1 a shannon-3.1-pro. GET /v1/models pro ně hlásí capabilities.json_schema: true. Strukturované výstupy

/v1/responses čte text.format (json_object nebo json_schema) pro strukturovaný výstup. Responses API

/v1/responses vrací uvažování modelů Shannon: výstupní položku reasoning před položkou message a události streamu response.reasoning_summary_text.delta a response.reasoning_summary_text.done. Responses API

Pole model v odpovědi je na každém endpointu zveřejněné id. Objekt Responses nese model a created_at.

GET /v1/models hlásí kontextové okno každého modelu. Modely a ceny

Hostované modely s otevřenými váhami odpovídají na /v1/messages a /v1/responses stejně jako na /v1/chat/completions, s vaším systémovým promptem a voláními nástrojů. /v1/messages přijímá thinking a reasoning_effort je pole požadavku. Modely a ceny

Těla chyb na /v1 sledují tvary z SDK: objekt error s type a message na endpointech ve formátu OpenAI a stejný objekt uvnitř {"type": "error"} na /v1/messages. Zpracování chyb

Keep-alive na otevřených streamech každých 15 sekund: řádek komentáře : ping na /v1/chat/completions, event: ping na /v1/messages. Streamování

Id volání nástrojů začínají na call_ na /v1/chat/completions a /v1/responses a na toolu_ na /v1/messages. Volání funkcí

/v1/responses: stream je ve výchozím stavu false. Responses API

max_completion_tokens se na /v1/chat/completions přijímá jako další název pro max_tokens. Chat Completions

Událost response.completed streamu Responses nese pole output. Responses API

Položky GET /v1/models nesou display_name, context_window, max_output_tokens, pricing, capabilities a endpoints. Modely a ceny

Každá odpověď nese x-request-id a hodnota, kterou pošlete, se vrací. Těla požadavků mohou mít až 32 MiB.

Platnost klíče lze zrušit, aniž by se vydal nový. Záznam využití je stránkovaný.

Obrázky a dokumenty v požadavcích: části image_url na /v1/chat/completions, bloky image, document a file na /v1/messages, části input_image na /v1/responses. Obrázky a soubory

Nový model shannon-3-pro. Modely a ceny

Nový model shannon-3. Modely a ceny

Streamy na /v1/chat/completions nesou uvažování jako delta.reasoning_content. Úsilí uvažování

max_tokens se drží v rozsahu 1 až 65,536. Hodnota mimo tento rozsah se posune na nejbližší mez, nezamítá se. Chat Completions

shannon-coder-1 se na /v1/chat/completions a /v1/messages počítá na volání podle plánu. Když jsou volání okna vyčerpána, odpověď je 429 se zprávou Shannon Coder call quota reached. CLI nástroje pro programování

Na konverzaci větší než kontextové okno se odpovídá 400, typem invalid_request_error a kódem context_length_exceeded. Chyba uvnitř streamu přichází jako událost chyby, ne jako text v odpovědi. CLI nástroje pro programování

Endpointy /v1: POST /v1/chat/completions, POST /v1/messages, POST /v1/responses a GET /v1/models. Jsou to endpointy, které volají SDK OpenAI a Anthropic, Claude Code a Codex CLI. Přehled

Volání nástrojů pomocí tools na /v1/chat/completions a /v1/messages, strukturovaný výstup pomocí response_format a system jako řetězec nebo textové bloky na /v1/messages. Volání funkcí

Id modelů shannon-1.6-pro, shannon-2-lite, shannon-2-pro a shannon-coder-1, vedle shannon-1.6-lite. Modely a ceny

První vydání API: chat ve formátu OpenAI a ve formátu Anthropic a endpoint Responses, každý volaný s API klíčem začínajícím na sk-. Ověření