Salti al la enhavo
Ŝanĝprotokolo

Ŝ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: true nomas siajn fontojn: sources ĉe /v1/chat/completions kaj /v1/messages listigas la rezultojn, kiujn la modelo ricevis, kaj ĉe /v1/chat/completions annotations markas, kie la respondo citas ĉiun el ili. Retserĉo

  • Nova

    web_search: true ĉe /v1/chat/completions kaj /v1/messages faras 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-1 respondas ĉe /v1/responses same kiel ĉe la aliaj du endpoints. CLI-iloj por programado

  • Riparita

    Rotaciita API-ŝlosilo tuj ĉesas funkcii.

  • Nova

    POST /v1/tokenize kaj POST /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_tokens kaj cache_read_input_tokens. GET /v1/models raportas pricing.cached_input_per_million_usd kaj capabilities.prompt_caching por ĉi tiuj modeloj. Prompt-kaŝado

  • Riparita

    Gastigitaj malfermpezaj modeloj: altrudita tool_choice (required aŭ 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.com portas la du adresojn en la kapoj Onion-Location kaj X-I2P-Location. Ĉifritaj endpoints, Tor & I2P

  • Nova

    Novaj modeloj shannon-3.1 kaj shannon-3.1-pro, listigitaj de GET /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/responses aperas en la uzada protokolo.

  • Nova

    Gastigitaj malfermpezaj modeloj aplikas la specimenajn kampojn: temperature, top_p, seed, stop kaj max_tokens ĉe /v1/chat/completions; temperature, top_p kaj stop_sequences ĉe /v1/messages; temperature, top_p kaj max_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 respondon 400, la tipon invalid_request_error kaj la mesaĝon unknown model: <id> ĉe ĉiuj tri endpoints. Antaŭe tia peto estis respondata de shannon-1.6-lite. Modeloj kaj prezoj

  • Rompa

    /v1 akceptas 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 respondon 503 kaj la tipon api_error. Erarotraktado

  • Riparita

    Nefluata peto, kiu malsukcesas, redonas sian rezervon al via saldo.

  • Nova

    GET /v1/models raportas capabilities.reasoning_effort por ĉiu modelo. Peno de reasoning

  • Plibonigita

    Gastigitaj malfermpezaj modeloj: nefluata peto, kiu ne ricevas respondon, finiĝas per 504 kaj la tipo api_error. Malplena rezulto estas 502. Erarotraktado

  • Rompa

    Gastigitaj malfermpezaj modeloj akceptas la enigon, kiun akceptas la nomita modelo. Bildo sendita al id nur por teksto ricevas respondon 400 kaj <id> does not accept image input. response_format ĉe id sen strukturita eligo ricevas respondon 400. GET /v1/models raportas capabilities.vision, response_format kaj json_schema por ĉiu id. Bildoj kaj dosieroj

  • Riparita

    Nefluataj respondoj portas la reasoning-tekston: reasoning_content en la mesaĝo de /v1/chat/completions, kaj bloko thinking antaŭ 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.1 kaj shannon-3.1-pro. GET /v1/models raportas por ili capabilities.json_schema: true. Strukturitaj eligoj

  • Nova

    /v1/responses legas text.format (json_object aŭ json_schema) por strukturita eligo. Responses API

  • Riparita

    /v1/responses redonas la reasoning de la Shannon-modeloj: eligan eron reasoning antaŭ la ero message, kaj la fluajn eventojn response.reasoning_summary_text.delta kaj response.reasoning_summary_text.done. Responses API

  • Riparita

    La kampo model de respondo estas la publikigita id ĉe ĉiu endpoint. Objekto Responses portas model kaj created_at.

  • Plibonigita

    GET /v1/models raportas la kuntekstan fenestron de ĉiu modelo. Modeloj kaj prezoj

  • Nova

    Gastigitaj malfermpezaj modeloj respondas ĉe /v1/messages kaj /v1/responses same kiel ĉe /v1/chat/completions, kun via system prompt kaj ilovokoj. /v1/messages akceptas thinking, kaj reasoning_effort estas peto-kampo. Modeloj kaj prezoj

  • Plibonigita

    Erarkorpoj ĉe /v1 sekvas la formojn de la SDK-oj: objekto error kun type kaj message ĉ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/completions kaj /v1/responses, kaj per toolu_ ĉe /v1/messages. Funkci-alvokoj

  • Rompa

    /v1/responses: stream havas defaŭltan valoron false. Responses API

  • Nova

    max_completion_tokens estas akceptata kiel alia nomo de max_tokens ĉe /v1/chat/completions. Chat Completions

  • Riparita

    La evento response.completed de fluo Responses portas la tabelon output. Responses API

  • Nova

    Eroj de GET /v1/models portas display_name, context_window, max_output_tokens, pricing, capabilities kaj endpoints. 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, blokoj image, document kaj file ĉe /v1/messages, partoj input_image ĉe /v1/responses. Bildoj kaj dosieroj

  • Nova

    Nova modelo shannon-3-pro. Modeloj kaj prezoj

  • Ŝanĝita

    max_tokens estas tenata inter 1 kaj 65,536. Valoro ekster tiu intervalo estas movata al la plej proksima fino, ne rifuzata. Chat Completions

  • Nova

    shannon-coder-1 estas kalkulata en vokoj por plano ĉe /v1/chat/completions kaj /v1/messages. Kiam la vokoj de fenestro estas elĉerpitaj, la respondo estas 429 kun la mesaĝo Shannon Coder call quota reached. CLI-iloj por programado

  • Nova

    Konversacio pli granda ol la kunteksta fenestro ricevas respondon 400, la tipon invalid_request_error kaj la kodon context_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/responses kaj GET /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/completions kaj /v1/messages, strukturita eligo per response_format, kaj system kiel ĉeno aŭ kiel tekstaj blokoj ĉe /v1/messages. Funkci-alvokoj

  • Nova

    Modelo-id-oj shannon-1.6-pro, shannon-2-lite, shannon-2-pro kaj shannon-coder-1, apud shannon-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