Ŝanĝprotokolo
Lastatempaj ĝisdatigoj kaj plibonigoj al la Shannon API.
Ĉi tiu paĝo listigas la ŝanĝojn, kiujn vi povas observi kiel vokanto de la API: novaj endpoints, kampoj kaj modeloj, ŝanĝita konduto kaj riparoj. La plej novaj eroj venas unue. Ĉiu ero portas la daton de la ŝanĝo.
Ero markita Rompa povas ŝanĝi la rezulton de peto, kiu antaŭe funkciis. La API havas unu version, /v1, do ŝanĝoj estas listigitaj laŭ dato kaj ne laŭ versionumero.
- Nova
Peto kun
web_search: truenomas siajn fontojn:sourcesĉe/v1/chat/completionskaj/v1/messageslistigas la rezultojn, kiujn la modelo ricevis, kaj ĉe/v1/chat/completionsannotationsmarkas, kie la respondo citas ĉiun el ili. Retserĉo
- Nova
web_search: trueĉe/v1/chat/completionskaj/v1/messagesfaras retserĉon antaŭ ol la modelo respondas kaj donas al ĝi la rezultojn kiel numeritajn fontojn. Peto, kiu trovis rezultojn, uzas unu serĉon de via ĉiutaga kvoto. Se neniu restas, la peto estas respondata sen serĉo. Retserĉo
- Riparita
Fluo detranĉita flanke de la servilo estas fakturata laŭ la uzado raportita ĝis tiu punkto. La resto de la rezervo revenas al via saldo.
- Riparita
shannon-coder-1respondas ĉe/v1/responsessame kiel ĉe la aliaj du endpoints. CLI-iloj por programado - Riparita
Rotaciita API-ŝlosilo tuj ĉesas funkcii.
- Nova
POST /v1/tokenizekajPOST /v1/messages/count_tokens: senpagaj kalkuloj de tokenoj por la gastigitaj malfermpezaj modeloj. Kalkulado de tokenoj - Nova
Prompt caching ĉe la gastigitaj malfermpezaj modeloj. Kaŝmemorita enigo estas fakturata je 25% de la enira prezo kaj raportata en
usageĉe ĉiuj tri endpoints:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokenskajcache_read_input_tokens.GET /v1/modelsraportaspricing.cached_input_per_million_usdkajcapabilities.prompt_cachingpor ĉi tiuj modeloj. Prompt-kaŝado - Riparita
Gastigitaj malfermpezaj modeloj: altrudita
tool_choice(requiredaŭ nomita funkcio) donas ilovokon. Funkci-alvokoj - Riparita
Gastigitaj malfermpezaj modeloj akceptas mesaĝon
system, kiu ne estas la unua mesaĝo de la konversacio.
- Nova
La API estas atingebla kiel Tor-onion-servo kaj ĉe I2P-adreso. Respondoj de
api.shannon-ai.comportas la du adresojn en la kapojOnion-LocationkajX-I2P-Location. Ĉifritaj endpoints, Tor & I2P
- Nova
Novaj modeloj
shannon-3.1kajshannon-3.1-pro, listigitaj deGET /v1/models. Modeloj kaj prezoj - Ŝanĝita
Fluata peto, kies kliento malkonektiĝas, funkcias ĝis sia fino kaj estas kalkulata. Antaŭe la respondo ĉesis ĉe la malkonekto.
- Riparita
Petoj al
/v1/responsesaperas en la uzada protokolo.
- Nova
Gastigitaj malfermpezaj modeloj aplikas la specimenajn kampojn:
temperature,top_p,seed,stopkajmax_tokensĉe/v1/chat/completions;temperature,top_pkajstop_sequencesĉe/v1/messages;temperature,top_pkajmax_output_tokensĉe/v1/responses. Chat Completions - Nova
La uzada protokolo montras koston en USD por ĉiu voko kaj kiel sumon.
- Rompa
Valoro de
model, kiu ne estas publikigita id, ricevas respondon400, la tiponinvalid_request_errorkaj la mesaĝonunknown model: <id>ĉe ĉiuj tri endpoints. Antaŭe tia peto estis respondata deshannon-1.6-lite. Modeloj kaj prezoj - Rompa
/v1akceptas nur API-ŝlosilon. Ensaluta kuketo de la retejo tie ne estas legata. Aŭtentigo - Ŝanĝita
Flood protection: 120 petoj por minuto por konto ĉe la tri generaj endpoints. Limoj kaj saldo
- Plibonigita
Kiam la modelo ne povas respondi, la eraro portas la fiksan mesaĝon
The model backend failed to answer. Please retry.Salda kontrolo, kiun oni ne povas fari, ricevas respondon503kaj la tiponapi_error. Erarotraktado - Riparita
Nefluata peto, kiu malsukcesas, redonas sian rezervon al via saldo.
- Nova
GET /v1/modelsraportascapabilities.reasoning_effortpor ĉiu modelo. Peno de reasoning - Plibonigita
Gastigitaj malfermpezaj modeloj: nefluata peto, kiu ne ricevas respondon, finiĝas per
504kaj la tipoapi_error. Malplena rezulto estas502. Erarotraktado
- Rompa
Gastigitaj malfermpezaj modeloj akceptas la enigon, kiun akceptas la nomita modelo. Bildo sendita al id nur por teksto ricevas respondon
400kaj<id> does not accept image input.response_formatĉe id sen strukturita eligo ricevas respondon400.GET /v1/modelsraportascapabilities.vision,response_formatkajjson_schemapor ĉiu id. Bildoj kaj dosieroj - Riparita
Nefluataj respondoj portas la reasoning-tekston:
reasoning_contenten la mesaĝo de/v1/chat/completions, kaj blokothinkingantaŭ la teksto ĉe/v1/messages. Peno de reasoning - Ŝanĝita
Gastigitaj malfermpezaj modeloj havas novajn prezojn, ekde $0.50 por 1M enirtokenoj kaj $2.00 por 1M eligtokenoj. Modeloj kaj prezoj
- Ŝanĝita
Gastigitaj malfermpezaj modeloj havas unu id por modelo, entute dek du id-oj. Modeloj kaj prezoj
- Nova
Strukturita eligo ĉe
shannon-3,shannon-3-pro,shannon-3.1kajshannon-3.1-pro.GET /v1/modelsraportas por ilicapabilities.json_schema: true. Strukturitaj eligoj - Nova
/v1/responseslegastext.format(json_objectaŭjson_schema) por strukturita eligo. Responses API - Riparita
/v1/responsesredonas la reasoning de la Shannon-modeloj: eligan eronreasoningantaŭ la eromessage, kaj la fluajn eventojnresponse.reasoning_summary_text.deltakajresponse.reasoning_summary_text.done. Responses API - Riparita
La kampo
modelde respondo estas la publikigita id ĉe ĉiu endpoint. Objekto Responses portasmodelkajcreated_at. - Plibonigita
GET /v1/modelsraportas la kuntekstan fenestron de ĉiu modelo. Modeloj kaj prezoj
- Nova
Gastigitaj malfermpezaj modeloj respondas ĉe
/v1/messageskaj/v1/responsessame kiel ĉe/v1/chat/completions, kun via system prompt kaj ilovokoj./v1/messagesakceptasthinking, kajreasoning_effortestas peto-kampo. Modeloj kaj prezoj - Plibonigita
Erarkorpoj ĉe
/v1sekvas la formojn de la SDK-oj: objektoerrorkuntypekajmessageĉe la endpoints en formato de OpenAI, kaj la sama objekto ene de{"type": "error"}ĉe/v1/messages. Erarotraktado - Nova
Keep-alive en malfermaj fluoj ĉiujn 15 sekundojn: komenta linio
: pingĉe/v1/chat/completions,event: pingĉe/v1/messages. Fluigo - Ŝanĝita
Id-oj de ilovokoj komenciĝas per
call_ĉe/v1/chat/completionskaj/v1/responses, kaj pertoolu_ĉe/v1/messages. Funkci-alvokoj - Rompa
/v1/responses:streamhavas defaŭltan valoronfalse. Responses API - Nova
max_completion_tokensestas akceptata kiel alia nomo demax_tokensĉe/v1/chat/completions. Chat Completions - Riparita
La evento
response.completedde fluo Responses portas la tabelonoutput. Responses API - Nova
Eroj de
GET /v1/modelsportasdisplay_name,context_window,max_output_tokens,pricing,capabilitieskajendpoints. Modeloj kaj prezoj - Nova
Ĉiu respondo portas
x-request-id, kaj valoro, kiun vi sendas, estas resendata. Petkorpoj povas atingi 32 MiB. - Nova
Ŝlosilo povas esti revokita sen eldono de nova. La uzada protokolo estas paĝigita.
- Nova
Bildoj kaj dokumentoj en petoj: partoj
image_urlĉe/v1/chat/completions, blokojimage,documentkajfileĉe/v1/messages, partojinput_imageĉe/v1/responses. Bildoj kaj dosieroj - Nova
Nova modelo
shannon-3-pro. Modeloj kaj prezoj
- Nova
Nova modelo
shannon-3. Modeloj kaj prezoj - Nova
Fluoj ĉe
/v1/chat/completionsportas la reasoning kieldelta.reasoning_content. Peno de reasoning
- Ŝanĝita
max_tokensestas tenata inter 1 kaj 65,536. Valoro ekster tiu intervalo estas movata al la plej proksima fino, ne rifuzata. Chat Completions
- Nova
shannon-coder-1estas kalkulata en vokoj por plano ĉe/v1/chat/completionskaj/v1/messages. Kiam la vokoj de fenestro estas elĉerpitaj, la respondo estas429kun la mesaĝoShannon Coder call quota reached. CLI-iloj por programado - Nova
Konversacio pli granda ol la kunteksta fenestro ricevas respondon
400, la tiponinvalid_request_errorkaj la kodoncontext_length_exceeded. Eraro ene de fluo alvenas kiel erar-evento, ne kiel teksto en la respondo. CLI-iloj por programado
- Nova
La endpoints de
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responseskajGET /v1/models. Ili estas la endpoints, kiujn vokas la SDK-oj de OpenAI kaj Anthropic, Claude Code kaj Codex CLI. Superrigardo - Nova
Ilovokoj per
toolsĉe/v1/chat/completionskaj/v1/messages, strukturita eligo perresponse_format, kajsystemkiel ĉeno aŭ kiel tekstaj blokoj ĉe/v1/messages. Funkci-alvokoj
- Nova
Modelo-id-oj
shannon-1.6-pro,shannon-2-lite,shannon-2-prokajshannon-coder-1, apudshannon-1.6-lite. Modeloj kaj prezoj
- Nova
Unua eldono de la API: babilo en la formato de OpenAI kaj en la formato de Anthropic, kaj endpoint Responses, ĉiu vokata per API-ŝlosilo, kiu komenciĝas per
sk-. Aŭtentigo