Muudatuste logi
Hiljutised uuendused ja parandused Shannon API-s.
See leht loetleb muudatused, mida API kutsujana märkad: uued lõpp-punktid, väljad ja mudelid, muutunud käitumine ja parandused. Uusimad kirjed on esimesena. Iga kirje kannab muudatuse tegemise kuupäeva.
Kirje, mis on märgitud Ühilduvust rikkuv, võib muuta varem töötanud päringu tulemust. API-l on üks versioon, /v1, seega muudatused on loetletud kuupäeva, mitte versiooninumbri järgi.
- Uus
Päring, milles on
web_search: true, nimetab oma allikad:sourceslõpp-punktides/v1/chat/completionsja/v1/messagesloetleb tulemused, mille mudel sai, ja lõpp-punktis/v1/chat/completionsmärgibannotations, kus vastus igaühele viitab. Veebiotsing
- Uus
web_search: truelõpp-punktides/v1/chat/completionsja/v1/messagesteeb veebiotsingu enne mudeli vastust ja annab talle tulemused nummerdatud allikatena. Päring, mis leidis tulemusi, kasutab ühe otsingu sinu päevalimiidist. Kui ühtegi ei ole jäänud, vastatakse päringule ilma otsinguta. Veebiotsing
- Parandatud
Serveri poolel katkestatud voo eest arveldatakse selleni teatatud kasutus. Ülejäänud reserveering läheb tagasi sinu saldole.
- Parandatud
shannon-coder-1vastab lõpp-punktis/v1/responsesnagu teistes kahes lõpp-punktis. CLI kodeerimistööriistad - Parandatud
Vahetatud API võti lakkab töötamast kohe.
- Uus
POST /v1/tokenizejaPOST /v1/messages/count_tokens: tasuta tokenite lugemine hostitud avatud kaaludega mudelite jaoks. Tokenite lugemine - Uus
Prompti vahemällu panek hostitud avatud kaaludega mudelitel. Vahemälus olevat sisendit arveldatakse 25% sisendi hinnast ja sellest teatatakse väljas
usagekõigis kolmes lõpp-punktis:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensjacache_read_input_tokens.GET /v1/modelsteatab nendele mudelitelepricing.cached_input_per_million_usdjacapabilities.prompt_caching. Prompti vahemäljutamine - Parandatud
Hostitud avatud kaaludega mudelid: sunnitud
tool_choice(requiredvõi nimetatud funktsioon) annab tööriistakutse. Funktsioonikutse - Parandatud
Hostitud avatud kaaludega mudelid võtavad vastu
system-sõnumi, mis ei ole vestluse esimene sõnum.
- Uus
API on kättesaadav Tor onion-teenusena ja I2P aadressil. Vastused saidilt
api.shannon-ai.comkannavad mõlemat aadressi päistesOnion-LocationjaX-I2P-Location. Krüpteeritud, Tor ja I2P lõpp-punktid
- Uus
Uued mudelid
shannon-3.1jashannon-3.1-pro, mida loetlebGET /v1/models. Mudelid ja hinnad - Muudetud
Voogedastatud päring, mille klient ühenduse katkestab, jookseb lõpuni ja loetakse arvesse. Varem peatus vastus katkestuse hetkel.
- Parandatud
Päringud lõpp-punkti
/v1/responsesilmuvad kasutuslogis.
- Uus
Hostitud avatud kaaludega mudelid rakendavad valimisvälju:
temperature,top_p,seed,stopjamax_tokenslõpp-punktis/v1/chat/completions;temperature,top_pjastop_sequenceslõpp-punktis/v1/messages;temperature,top_pjamax_output_tokenslõpp-punktis/v1/responses. Chat Completions - Uus
Kasutuslogi näitab hinda USD-des iga kõne kohta ja kokku.
- Ühilduvust rikkuv
modelväärtusele, mis ei ole avaldatud id, vastatakse400, tüübigainvalid_request_errorja teategaunknown model: <id>kõigis kolmes lõpp-punktis. Varem vastas sellisele päringuleshannon-1.6-lite. Mudelid ja hinnad - Ühilduvust rikkuv
/v1võtab ainult API võtit. Veebisaidi sisselogimisküpsist seal ei loeta. Autentimine - Muudetud
Kiirusepiirang: 120 päringut minutis konto kohta kolmes genereerimise lõpp-punktis. Piirangud ja saldo
- Täiustatud
Kui mudel ei suuda vastata, kannab viga kindlat teadet
The model backend failed to answer. Please retry.Saldo kontrollile, mida ei saa teha, vastatakse503ja tüübigaapi_error. Vigade käsitlus - Parandatud
Mittevoogedastatud päring, mis ebaõnnestub, annab oma reserveeringu sinu saldole tagasi.
- Uus
GET /v1/modelsteatab igale mudelilecapabilities.reasoning_effort. Reasoning-pingutus - Täiustatud
Hostitud avatud kaaludega mudelid: mittevoogedastatud päring, mis vastust ei saa, lõpeb
504ja tüübigaapi_error. Tühi tulemus on502. Vigade käsitlus
- Ühilduvust rikkuv
Hostitud avatud kaaludega mudelid võtavad sisendi, mida nimetatud mudel võtab. Ainult teksti id-le saadetud pildile vastatakse
400ja<id> does not accept image input. Struktureeritud väljundita id-le saadetudresponse_formatsaab vastuseks400.GET /v1/modelsteatab igale id-lecapabilities.vision,response_formatjajson_schema. Pildid ja failid - Parandatud
Mittevoogedastatud vastused kannavad arutlusteksti:
reasoning_contentsõnumil lõpp-punktis/v1/chat/completionsjathinking-plokk teksti ees lõpp-punktis/v1/messages. Reasoning-pingutus - Muudetud
Hostitud avatud kaaludega mudelitel on uued hinnad alates $0.50 1M sisendtokeni ja $2.00 1M väljundtokeni kohta. Mudelid ja hinnad
- Muudetud
Hostitud avatud kaaludega mudelitel on mudeli kohta üks id, kokku kaksteist id-d. Mudelid ja hinnad
- Uus
Struktureeritud väljund mudelitel
shannon-3,shannon-3-pro,shannon-3.1jashannon-3.1-pro.GET /v1/modelsteatab neilecapabilities.json_schema: true. Struktureeritud väljundid - Uus
/v1/responsesloeb struktureeritud väljundi jaokstext.format(json_objectvõijson_schema). Responses API - Parandatud
/v1/responsestagastab Shannoni mudelite arutluse:reasoningväljundiüksuse ennemessageüksust ning voosündmusedresponse.reasoning_summary_text.deltajaresponse.reasoning_summary_text.done. Responses API - Parandatud
Vastuse väli
modelon avaldatud id igas lõpp-punktis. Responses-objekt kannab väljumodeljacreated_at. - Täiustatud
GET /v1/modelsteatab iga mudeli kontekstiakna. Mudelid ja hinnad
- Uus
Hostitud avatud kaaludega mudelid vastavad lõpp-punktides
/v1/messagesja/v1/responsessamuti nagu lõpp-punktis/v1/chat/completions, sinu süsteemiprompti ja tööriistakutsetega./v1/messagesvõtabthinkingjareasoning_efforton päringuväli. Mudelid ja hinnad - Täiustatud
Vea sisu lõpp-punktides
/v1järgib SDK kujusid:error-objekt väljadegatypejamessageOpenAI formaadi lõpp-punktides ning sama objekt{"type": "error"}sees lõpp-punktis/v1/messages. Vigade käsitlus - Uus
Keep-alive avatud voogudel iga 15 sekundi järel: kommentaarirea
: pinglõpp-punktis/v1/chat/completions,event: pinglõpp-punktis/v1/messages. Voogedastus - Muudetud
Tööriistakutsete id-d algavad lõpp-punktides
/v1/chat/completionsja/v1/responsestekstigacall_ning lõpp-punktis/v1/messagestekstigatoolu_. Funktsioonikutse - Ühilduvust rikkuv
/v1/responses:streamvaikeväärtus onfalse. Responses API - Uus
max_completion_tokensvõetakse vastumax_tokensteise nimena lõpp-punktis/v1/chat/completions. Chat Completions - Parandatud
Responses-voo sündmus
response.completedkannab massiivioutput. Responses API - Uus
GET /v1/modelskirjed kannavad väljudisplay_name,context_window,max_output_tokens,pricing,capabilitiesjaendpoints. Mudelid ja hinnad - Uus
Iga vastus kannab päist
x-request-idja sinu saadetud väärtus tagastatakse. Päringu sisu võib olla kuni 32 MiB. - Uus
Võtme saab tühistada ilma uut välja andmata. Kasutuslogi on lehitsetav lehtedena.
- Uus
Pildid ja dokumendid päringutes:
image_urlosad lõpp-punktis/v1/chat/completions,image-,document- jafile-plokid lõpp-punktis/v1/messages,input_imageosad lõpp-punktis/v1/responses. Pildid ja failid - Uus
Uus mudel
shannon-3-pro. Mudelid ja hinnad
- Uus
Uus mudel
shannon-3. Mudelid ja hinnad - Uus
Voogudes lõpp-punktis
/v1/chat/completionstuleb arutlus kujuldelta.reasoning_content. Reasoning-pingutus
- Muudetud
max_tokenshoitakse vahemikus 1 kuni 65,536. Vahemikust väljas olev väärtus tuuakse lähima äärmuseni, mitte ei lükata tagasi. Chat Completions
- Uus
shannon-coder-1loetakse kõnedes paketi kohta lõpp-punktides/v1/chat/completionsja/v1/messages. Kui akna kõned on kasutatud, on vastus429teategaShannon Coder call quota reached. CLI kodeerimistööriistad - Uus
Vestlusele, mis on suurem kui kontekstiaken, vastatakse
400, tüübigainvalid_request_errorja koodigacontext_length_exceeded. Voo sees olev tõrge saabub veasündmusena, mitte tekstina vastuses. CLI kodeerimistööriistad
- Uus
Lõpp-punktid
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesjaGET /v1/models. Need on lõpp-punktid, mida kutsuvad OpenAI ja Anthropic SDK-d, Claude Code ja Codex CLI. Ülevaade - Uus
Tööriistakutsed väljaga
toolslõpp-punktides/v1/chat/completionsja/v1/messages, struktureeritud väljund väljagaresponse_formatningsystemstringina või tekstiplokkidena lõpp-punktis/v1/messages. Funktsioonikutse
- Uus
Mudeli id-d
shannon-1.6-pro,shannon-2-lite,shannon-2-projashannon-coder-1mudelishannon-1.6-litekõrval. Mudelid ja hinnad
- Uus
API esimene väljalase: vestlus OpenAI formaadis ja Anthropic formaadis ning Responses-lõpp-punkt, iga kutsutakse API võtmega, mis algab
sk-. Autentimine