Ændringslog
Seneste opdateringer og forbedringer af Shannon API.
Denne side viser de ændringer, du kan se som kalder af API'et: nye endpoints, felter og modeller, ændret adfærd og rettelser. De nyeste poster står først. Hver post har den dato, ændringen blev foretaget.
En post markeret Brydende kan ændre resultatet af en anmodning, der virkede før. API'et har én version, /v1, så ændringer er opført efter dato og ikke efter versionsnummer.
- Ny
En anmodning med
web_search: truenavngiver sine kilder:sourcespå/v1/chat/completionsog/v1/messageslister de resultater, modellen fik, og på/v1/chat/completionsmarkererannotations, hvor svaret citerer hvert af dem. Indbygget websøgning
- Ny
web_search: truepå/v1/chat/completionsog/v1/messageskører en websøgning, før modellen svarer, og giver den resultaterne som nummererede kilder. En anmodning, der fandt resultater, bruger én søgning af din daglige kvote. Når der ikke er flere tilbage, besvares anmodningen uden søgning. Indbygget websøgning
- Rettet
En stream, der afbrydes på serversiden, afregnes for det forbrug, der er rapporteret indtil da. Resten af reservationen går tilbage til din saldo.
- Rettet
shannon-coder-1svarer på/v1/responses, som den gør på de to andre endpoints. CLI-kodeværktøjer - Rettet
En roteret API-nøgle holder op med at virke med det samme.
- Ny
POST /v1/tokenizeogPOST /v1/messages/count_tokens: gratis tokentælling for de hostede open-weight-modeller. Tælling af tokens - Ny
Prompt caching på de hostede open-weight-modeller. Cachet input afregnes til 25% af inputprisen og rapporteres i
usagepå alle tre endpoints:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensogcache_read_input_tokens.GET /v1/modelsrapportererpricing.cached_input_per_million_usdogcapabilities.prompt_cachingfor disse modeller. Prompt-caching - Rettet
Hostede open-weight-modeller: et gennemtvunget
tool_choice(requiredeller en navngiven funktion) giver et værktøjskald. Funktionskald - Rettet
Hostede open-weight-modeller accepterer en
system-besked, der ikke er samtalens første besked.
- Ny
API'et kan nås som en Tor onion-tjeneste og på en I2P-adresse. Svar fra
api.shannon-ai.comindeholder de to adresser i headerneOnion-LocationogX-I2P-Location. Krypterede endpoints, Tor og I2P
- Ny
Nye modeller
shannon-3.1ogshannon-3.1-pro, opført afGET /v1/models. Modeller og priser - Ændret
En streamet anmodning, hvis klient afbryder forbindelsen, kører til ende og tælles med. Tidligere stoppede svaret ved afbrydelsen.
- Rettet
Anmodninger til
/v1/responsesvises i forbrugsloggen.
- Ny
Hostede open-weight-modeller anvender samplingfelterne:
temperature,top_p,seed,stopogmax_tokenspå/v1/chat/completions;temperature,top_pogstop_sequencespå/v1/messages;temperature,top_pogmax_output_tokenspå/v1/responses. Chat Completions - Ny
Forbrugsloggen viser en pris i USD for hvert kald og som total.
- Brydende
En
model-værdi, der ikke er et offentliggjort id, besvares med400, typeninvalid_request_errorog beskedenunknown model: <id>på alle tre endpoints. Tidligere blev en sådan anmodning besvaret afshannon-1.6-lite. Modeller og priser - Brydende
/v1tager kun en API-nøgle. En login-cookie fra websitet læses ikke dér. Godkendelse - Ændret
Flood protection: 120 anmodninger per minut per konto på de tre genereringsendpoints. Grænser og saldo
- Forbedret
Når modellen ikke kan svare, indeholder fejlen den faste besked
The model backend failed to answer. Please retry.En saldokontrol, der ikke kan udføres, besvares med503og typenapi_error. Fejlhåndtering - Rettet
En ikke-streamet anmodning, der fejler, giver sin reservation tilbage til din saldo.
- Ny
GET /v1/modelsrapporterercapabilities.reasoning_effortfor hver model. Reasoning effort - Forbedret
Hostede open-weight-modeller: en ikke-streamet anmodning, der ikke får noget svar, ender med
504og typenapi_error. Et tomt resultat er502. Fejlhåndtering
- Brydende
Hostede open-weight-modeller tager det input, den navngivne model tager. Et billede sendt til et id kun til tekst besvares med
400og<id> does not accept image input.response_formatpå et id uden struktureret output besvares med400.GET /v1/modelsrapporterercapabilities.vision,response_formatogjson_schemafor hvert id. Billeder og filer - Rettet
Ikke-streamede svar indeholder reasoning-teksten:
reasoning_contentpå beskeden i/v1/chat/completionsog enthinking-blok før teksten på/v1/messages. Reasoning effort - Ændret
Hostede open-weight-modeller har nye priser, fra $0.50 per 1M input-tokens og $2.00 per 1M output-tokens. Modeller og priser
- Ændret
Hostede open-weight-modeller har ét id per model, tolv id'er i alt. Modeller og priser
- Ny
Struktureret output på
shannon-3,shannon-3-pro,shannon-3.1ogshannon-3.1-pro.GET /v1/modelsrapporterercapabilities.json_schema: truefor dem. Strukturerede outputs - Ny
/v1/responseslæsertext.format(json_objectellerjson_schema) til struktureret output. Responses API - Rettet
/v1/responsesreturnerer Shannon-modellernes reasoning: etreasoning-outputelement førmessage-elementet og stream-hændelserneresponse.reasoning_summary_text.deltaogresponse.reasoning_summary_text.done. Responses API - Rettet
Feltet
modeli et svar er det offentliggjorte id på alle endpoints. Et Responses-objekt indeholdermodelogcreated_at. - Forbedret
GET /v1/modelsrapporterer hver models kontekstvindue. Modeller og priser
- Ny
Hostede open-weight-modeller svarer på
/v1/messagesog/v1/responsessåvel som på/v1/chat/completionsmed din system prompt og dine værktøjskald./v1/messagestagerthinking, ogreasoning_efforter et anmodningsfelt. Modeller og priser - Forbedret
Fejlindhold på
/v1følger SDK'ernes former: eterror-objekt medtypeogmessagepå endpoints i OpenAI-format og det samme objekt inde i{"type": "error"}på/v1/messages. Fejlhåndtering - Ny
Keep-alive på åbne streams hvert 15. sekund: en kommentarlinje
: pingpå/v1/chat/completionsog enevent: pingpå/v1/messages. Streaming - Ændret
Id'er på værktøjskald begynder med
call_på/v1/chat/completionsog/v1/responsesog medtoolu_på/v1/messages. Funktionskald - Brydende
/v1/responses:streamer som standardfalse. Responses API - Ny
max_completion_tokensaccepteres som et andet navn formax_tokenspå/v1/chat/completions. Chat Completions - Rettet
Hændelsen
response.completedi en Responses-stream indeholder arrayetoutput. Responses API - Ny
Poster i
GET /v1/modelsindeholderdisplay_name,context_window,max_output_tokens,pricing,capabilitiesogendpoints. Modeller og priser - Ny
Hvert svar indeholder
x-request-id, og en værdi, du sender, returneres. Anmodningers body kan være op til 32 MiB. - Ny
En nøgle kan tilbagekaldes, uden at der udstedes en ny. Forbrugsloggen er delt op i sider.
- Ny
Billeder og dokumenter i anmodninger:
image_url-dele på/v1/chat/completions,image-,document- ogfile-blokke på/v1/messages,input_image-dele på/v1/responses. Billeder og filer - Ny
Ny model
shannon-3-pro. Modeller og priser
- Ny
Ny model
shannon-3. Modeller og priser - Ny
Streams på
/v1/chat/completionsbærer reasoning somdelta.reasoning_content. Reasoning effort
- Ændret
max_tokensholdes inden for 1 til 65,536. En værdi uden for intervallet bringes til den nærmeste ende og afvises ikke. Chat Completions
- Ny
shannon-coder-1tælles i kald per plan på/v1/chat/completionsog/v1/messages. Når et vindues kald er brugt op, er svaret429med beskedenShannon Coder call quota reached. CLI-kodeværktøjer - Ny
En samtale, der er større end kontekstvinduet, besvares med
400, typeninvalid_request_errorog kodencontext_length_exceeded. En fejl inde i en stream kommer som en fejlhændelse, ikke som tekst i svaret. CLI-kodeværktøjer
- Ny
/v1-endpoints:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesogGET /v1/models. Det er de endpoints, som OpenAI- og Anthropic-SDK'erne, Claude Code og Codex CLI kalder. Overblik - Ny
Værktøjskald med
toolspå/v1/chat/completionsog/v1/messages, struktureret output medresponse_formatogsystemsom streng eller som tekstblokke på/v1/messages. Funktionskald
- Ny
Model-id'erne
shannon-1.6-pro,shannon-2-lite,shannon-2-proogshannon-coder-1ved siden afshannon-1.6-lite. Modeller og priser
- Ny
Første udgivelse af API'et: chat i OpenAI-formatet og i Anthropic-formatet samt et Responses-endpoint, hver kaldt med en API-nøgle, der begynder med
sk-. Godkendelse