Log perubahan
Kemas kini dan peningkatan terkini pada API Shannon.
Halaman ini menyenaraikan perubahan yang dapat anda perhatikan sebagai pemanggil API: endpoint, medan dan model baharu, tingkah laku yang diubah dan pembetulan. Entri terbaharu datang dahulu. Setiap entri membawa tarikh perubahan itu dibuat.
Entri yang bertanda Breaking boleh mengubah hasil permintaan yang berfungsi sebelum ini. API ini mempunyai satu versi, /v1, jadi perubahan disenaraikan mengikut tarikh dan bukan mengikut nombor versi.
- baru
Permintaan dengan
web_search: truemenamakan sumbernya:sourcespada/v1/chat/completionsdan/v1/messagesmenyenaraikan hasil yang diberikan kepada model, dan pada/v1/chat/completionsannotationsmenandakan tempat jawapan memetik setiap satu. Carian Web Terbina dalam
- baru
web_search: truepada/v1/chat/completionsdan/v1/messagesmenjalankan carian web sebelum model menjawab dan memberikan hasilnya sebagai sumber bernombor. Permintaan yang menemui hasil menggunakan satu carian daripada kuota harian anda. Apabila tiada lagi, permintaan dijawab tanpa carian. Carian Web Terbina dalam
- tetap
Stream yang dipotong di sebelah pelayan dibilkan untuk penggunaan yang dilaporkan sehingga ketika itu. Baki tempahan dikembalikan kepada baki anda.
- tetap
shannon-coder-1menjawab pada/v1/responsesseperti pada dua endpoint yang lain. Alat pengekodan CLI - tetap
Kunci API yang diputar berhenti berfungsi serta-merta.
- baru
POST /v1/tokenizedanPOST /v1/messages/count_tokens: pengiraan token percuma untuk model open-weight yang dihoskan. Pengiraan token - baru
Caching prompt pada model open-weight yang dihoskan. Input cached dibilkan pada 25% daripada harga input dan dilaporkan dalam
usagepada ketiga-tiga endpoint:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokensdancache_read_input_tokens.GET /v1/modelsmelaporkanpricing.cached_input_per_million_usddancapabilities.prompt_cachinguntuk model ini. Caching prompt - tetap
Model open-weight yang dihoskan:
tool_choiceyang dipaksa (requiredatau fungsi bernama) menghasilkan panggilan alat. Panggilan Fungsi - tetap
Model open-weight yang dihoskan menerima mesej
systemyang bukan mesej pertama perbualan.
- baru
API boleh dicapai sebagai perkhidmatan onion Tor dan pada alamat I2P. Balasan
api.shannon-ai.commembawa kedua-dua alamat dalam headerOnion-LocationdanX-I2P-Location. Endpoint disulitkan, Tor & I2P
- baru
Model baharu
shannon-3.1danshannon-3.1-pro, disenaraikan olehGET /v1/models. Model & harga - Diubah
Permintaan stream yang kliennya terputus sambungan berjalan sehingga selesai dan dikira. Sebelum ini, jawapan berhenti ketika sambungan terputus.
- tetap
Permintaan ke
/v1/responsesmuncul dalam log penggunaan.
- baru
Model open-weight yang dihoskan melaksanakan medan persampelan:
temperature,top_p,seed,stopdanmax_tokenspada/v1/chat/completions;temperature,top_pdanstop_sequencespada/v1/messages;temperature,top_pdanmax_output_tokenspada/v1/responses. Chat Completions - baru
Log penggunaan menunjukkan kos dalam USD bagi setiap panggilan dan sebagai jumlah.
- Berbuka
Nilai
modelyang bukan id yang diterbitkan dijawab dengan400, jenisinvalid_request_errordan mesejunknown model: <id>pada ketiga-tiga endpoint. Sebelum ini, permintaan sedemikian dijawab olehshannon-1.6-lite. Model & harga - Berbuka
/v1hanya menerima kunci API. Kuki log masuk laman web tidak dibaca di sana. Pengesahan - Diubah
Perlindungan lonjakan: 120 permintaan seminit bagi setiap akaun pada ketiga-tiga endpoint penjanaan. Had dan baki
- bertambah baik
Apabila model tidak dapat menjawab, ralat membawa mesej tetap
The model backend failed to answer. Please retry.Semakan baki yang tidak dapat dibuat dijawab dengan503dan jenisapi_error. Pengendalian Ralat - tetap
Permintaan bukan stream yang gagal memulangkan tempahannya kepada baki anda.
- baru
GET /v1/modelsmelaporkancapabilities.reasoning_effortbagi setiap model. Usaha penaakulan - bertambah baik
Model open-weight yang dihoskan: permintaan bukan stream yang tidak mendapat jawapan berakhir dengan
504dan jenisapi_error. Hasil kosong ialah502. Pengendalian Ralat
- Berbuka
Model open-weight yang dihoskan menerima input yang diterima oleh model yang dinamakan. Imej yang dihantar kepada id teks sahaja dijawab dengan
400dan<id> does not accept image input.response_formatpada id tanpa output berstruktur dijawab dengan400.GET /v1/modelsmelaporkancapabilities.vision,response_formatdanjson_schemabagi setiap id. Imej dan fail - tetap
Balasan bukan stream membawa teks penaakulan:
reasoning_contentpada mesej/v1/chat/completions, dan blokthinkingsebelum teks pada/v1/messages. Usaha penaakulan - Diubah
Model open-weight yang dihoskan mempunyai harga baharu, bermula dari $0.50 setiap 1M token input dan $2.00 setiap 1M token output. Model & harga
- Diubah
Model open-weight yang dihoskan mempunyai satu id bagi setiap model, dua belas id kesemuanya. Model & harga
- baru
Output berstruktur pada
shannon-3,shannon-3-pro,shannon-3.1danshannon-3.1-pro.GET /v1/modelsmelaporkancapabilities.json_schema: trueuntuknya. Output Berstruktur - baru
/v1/responsesmembacatext.format(json_objectataujson_schema) untuk output berstruktur. API Responses - tetap
/v1/responsesmemulangkan penaakulan model Shannon: item outputreasoningsebelum itemmessage, dan peristiwa streamresponse.reasoning_summary_text.deltadanresponse.reasoning_summary_text.done. API Responses - tetap
Medan
modeldalam balasan ialah id yang diterbitkan pada setiap endpoint. Objek Responses membawamodeldancreated_at. - bertambah baik
GET /v1/modelsmelaporkan tetingkap konteks setiap model. Model & harga
- baru
Model open-weight yang dihoskan menjawab pada
/v1/messagesdan/v1/responsesserta pada/v1/chat/completions, dengan system prompt dan panggilan alat anda./v1/messagesmenerimathinking, danreasoning_effortialah medan permintaan. Model & harga - bertambah baik
Badan ralat pada
/v1mengikut bentuk SDK: objekerrordengantypedanmessagepada endpoint format OpenAI, dan objek yang sama di dalam{"type": "error"}pada/v1/messages. Pengendalian Ralat - baru
Keep-alive pada stream yang terbuka setiap 15 saat: baris komen
: pingpada/v1/chat/completions,event: pingpada/v1/messages. Penstriman - Diubah
Id panggilan alat bermula dengan
call_pada/v1/chat/completionsdan/v1/responses, dan dengantoolu_pada/v1/messages. Panggilan Fungsi - Berbuka
/v1/responses:streamlalai kepadafalse. API Responses - baru
max_completion_tokensditerima sebagai nama lain bagimax_tokenspada/v1/chat/completions. Chat Completions - tetap
Peristiwa
response.completedbagi stream Responses membawa tatasusunanoutput. API Responses - baru
Entri
GET /v1/modelsmembawadisplay_name,context_window,max_output_tokens,pricing,capabilitiesdanendpoints. Model & harga - baru
Setiap balasan membawa
x-request-id, dan nilai yang anda hantar dikembalikan. Badan permintaan boleh sehingga 32 MiB. - baru
Kunci boleh dibatalkan tanpa kunci baharu dikeluarkan. Log penggunaan dibahagikan kepada halaman.
- baru
Imej dan dokumen dalam permintaan: bahagian
image_urlpada/v1/chat/completions, blokimage,documentdanfilepada/v1/messages, bahagianinput_imagepada/v1/responses. Imej dan fail - baru
Model baharu
shannon-3-pro. Model & harga
- baru
Model baharu
shannon-3. Model & harga - baru
Stream pada
/v1/chat/completionsmembawa penaakulan sebagaidelta.reasoning_content. Usaha penaakulan
- Diubah
max_tokensdikekalkan dalam lingkungan 1 hingga 65,536. Nilai di luar julat itu dibawa ke hujung yang terdekat, bukan ditolak. Chat Completions
- baru
shannon-coder-1dikira dalam panggilan bagi setiap pelan pada/v1/chat/completionsdan/v1/messages. Apabila panggilan sesuatu tetingkap habis digunakan, balasannya ialah429dengan mesejShannon Coder call quota reached. Alat pengekodan CLI - baru
Perbualan yang lebih besar daripada tetingkap konteks dijawab dengan
400, jenisinvalid_request_errordan kodcontext_length_exceeded. Ralat di dalam stream tiba sebagai peristiwa ralat, bukan sebagai teks dalam jawapan. Alat pengekodan CLI
- baru
Endpoint
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responsesdanGET /v1/models. Ia ialah endpoint yang dipanggil oleh SDK OpenAI dan Anthropic, Claude Code dan Codex CLI. Gambaran keseluruhan - baru
Panggilan alat dengan
toolspada/v1/chat/completionsdan/v1/messages, output berstruktur denganresponse_format, dansystemsebagai rentetan atau sebagai blok teks pada/v1/messages. Panggilan Fungsi
- baru
Id model
shannon-1.6-pro,shannon-2-lite,shannon-2-prodanshannon-coder-1, di sampingshannon-1.6-lite. Model & harga
- baru
Keluaran pertama API: sembang dalam format OpenAI dan format Anthropic, serta endpoint Responses, masing-masing dipanggil dengan kunci API yang bermula dengan
sk-. Pengesahan