Catatan Perubahan
Pembaruan dan peningkatan terbaru pada Shannon API.
Halaman ini mencantumkan perubahan yang dapat Anda amati sebagai pemanggil API: endpoint, field, dan model baru, perilaku yang berubah, serta perbaikan. Entri terbaru berada di atas. Setiap entri membawa tanggal perubahan dibuat.
Entri yang bertanda Perubahan merusak dapat mengubah hasil permintaan yang sebelumnya berhasil. API hanya memiliki satu versi, /v1, sehingga perubahan dicantumkan menurut tanggal, bukan nomor versi.
- Baru
Permintaan dengan
web_search: truemenyebutkan sumbernya:sourcespada/v1/chat/completionsdan/v1/messagesmencantumkan hasil yang diberikan kepada model, dan pada/v1/chat/completions,annotationsmenandai di mana jawaban mengutip masing-masing. Pencarian Web Terintegrasi
- Baru
web_search: truedi/v1/chat/completionsdan/v1/messagesmenjalankan pencarian web sebelum model menjawab dan memberikan hasilnya sebagai sumber bernomor. Permintaan yang menemukan hasil memakai satu pencarian dari kuota harian Anda. Jika kuota habis, permintaan dijawab tanpa pencarian. Pencarian Web Terintegrasi
- Diperbaiki
Stream yang terputus dari sisi server ditagih sesuai usage yang dilaporkan hingga titik itu. Sisa cadangan dikembalikan ke saldo Anda.
- Diperbaiki
shannon-coder-1menjawab di/v1/responsesseperti di dua endpoint lainnya. Tool coding CLI - Diperbaiki
API key yang dirotasi langsung berhenti berfungsi.
- Baru
POST /v1/tokenizedanPOST /v1/messages/count_tokens: penghitungan token gratis untuk model open-weight hosted. Penghitungan token - Baru
Prompt caching pada model open-weight hosted. Input ter-cache ditagih 25% dari harga input dan dilaporkan di
usagepada ketiga endpoint:prompt_tokens_details.cached_tokens,input_tokens_details.cached_tokens, dancache_read_input_tokens.GET /v1/modelsmelaporkanpricing.cached_input_per_million_usddancapabilities.prompt_cachinguntuk model-model ini. Prompt caching - Diperbaiki
Model open-weight hosted:
tool_choiceyang dipaksakan (requiredatau fungsi bernama) menghasilkan panggilan tool. Pemanggilan fungsi - Diperbaiki
Model open-weight hosted menerima pesan
systemyang bukan pesan pertama dalam percakapan.
- Baru
API dapat diakses sebagai layanan onion Tor dan di alamat I2P. Balasan
api.shannon-ai.commembawa kedua alamat itu di headerOnion-LocationdanX-I2P-Location. Endpoint terenkripsi, Tor & I2P
- Baru
Model baru
shannon-3.1danshannon-3.1-pro, tercantum diGET /v1/models. Model & harga - Diubah
Permintaan streaming yang kliennya terputus dijalankan sampai selesai dan dihitung. Sebelumnya, jawaban berhenti saat terputus.
- Diperbaiki
Permintaan ke
/v1/responsesmuncul di log penggunaan.
- Baru
Model open-weight hosted menerapkan field sampling:
temperature,top_p,seed,stop, danmax_tokensdi/v1/chat/completions;temperature,top_p, danstop_sequencesdi/v1/messages;temperature,top_p, danmax_output_tokensdi/v1/responses. Chat Completions - Baru
Log penggunaan menampilkan biaya dalam USD untuk setiap panggilan dan sebagai total.
- Perubahan merusak
Nilai
modelyang bukan id yang dipublikasikan dijawab dengan400, tipeinvalid_request_error, dan pesanunknown model: <id>di ketiga endpoint. Sebelumnya, permintaan semacam itu dijawab olehshannon-1.6-lite. Model & harga - Perubahan merusak
/v1hanya menerima API key. Cookie login situs web tidak dibaca di sana. Autentikasi - Diubah
Flood protection: 120 permintaan per menit per akun pada ketiga endpoint generasi. Batas dan saldo
- Ditingkatkan
Ketika model tidak dapat menjawab, error membawa pesan tetap
The model backend failed to answer. Please retry.Pemeriksaan saldo yang tidak dapat dilakukan dijawab dengan503dan tipeapi_error. Penanganan kesalahan - Diperbaiki
Permintaan tanpa streaming yang gagal mengembalikan cadangannya ke saldo Anda.
- Baru
GET /v1/modelsmelaporkancapabilities.reasoning_effortuntuk setiap model. Reasoning effort - Ditingkatkan
Model open-weight hosted: permintaan tanpa streaming yang tidak mendapat jawaban berakhir dengan
504dan tipeapi_error. Hasil kosong adalah502. Penanganan kesalahan
- Perubahan merusak
Model open-weight hosted menerima input yang diterima model yang disebutkan namanya. Gambar yang dikirim ke id khusus teks dijawab dengan
400dan<id> does not accept image input.response_formatpada id tanpa output terstruktur dijawab dengan400.GET /v1/modelsmelaporkancapabilities.vision,response_format, danjson_schemauntuk setiap id. Gambar dan file - Diperbaiki
Balasan tanpa streaming membawa teks penalaran:
reasoning_contentpada pesan di/v1/chat/completions, dan blokthinkingsebelum teks di/v1/messages. Reasoning effort - Diubah
Model open-weight hosted memiliki harga baru, mulai dari $0.50 per 1M token input dan $2.00 per 1M token output. Model & harga
- Diubah
Model open-weight hosted memiliki satu id per model, total dua belas id. Model & harga
- Baru
Output terstruktur pada
shannon-3,shannon-3-pro,shannon-3.1, danshannon-3.1-pro.GET /v1/modelsmelaporkancapabilities.json_schema: trueuntuk model-model itu. Output Terstruktur - Baru
/v1/responsesmembacatext.format(json_objectataujson_schema) untuk output terstruktur. Responses API - Diperbaiki
/v1/responsesmengembalikan penalaran model Shannon: item outputreasoningsebelum itemmessage, serta event streamresponse.reasoning_summary_text.deltadanresponse.reasoning_summary_text.done. Responses API - Diperbaiki
Field
modelpada balasan adalah id yang dipublikasikan di setiap endpoint. Objek Responses membawamodeldancreated_at. - Ditingkatkan
GET /v1/modelsmelaporkan jendela konteks setiap model. Model & harga
- Baru
Model open-weight hosted menjawab di
/v1/messagesdan/v1/responsesselain di/v1/chat/completions, dengan system prompt dan panggilan tool Anda./v1/messagesmenerimathinking, danreasoning_effortadalah field permintaan. Model & harga - Ditingkatkan
Isi error di
/v1mengikuti bentuk SDK: objekerrordengantypedanmessagepada endpoint berformat OpenAI, dan objek yang sama di dalam{"type": "error"}pada/v1/messages. Penanganan kesalahan - Baru
Keep-alive pada stream terbuka setiap 15 detik: baris komentar
: pingdi/v1/chat/completions,event: pingdi/v1/messages. Streaming - Diubah
Id panggilan tool diawali
call_di/v1/chat/completionsdan/v1/responses, sertatoolu_di/v1/messages. Pemanggilan fungsi - Perubahan merusak
/v1/responses: defaultstreamadalahfalse. Responses API - Baru
max_completion_tokensditerima sebagai nama lain darimax_tokensdi/v1/chat/completions. Chat Completions - Diperbaiki
Event
response.completedpada stream Responses membawa arrayoutput. Responses API - Baru
Entri
GET /v1/modelsmembawadisplay_name,context_window,max_output_tokens,pricing,capabilities, danendpoints. Model & harga - Baru
Setiap balasan membawa
x-request-id, dan nilai yang Anda kirim dikembalikan. Body permintaan dapat berukuran hingga 32 MiB. - Baru
Kunci dapat dicabut tanpa menerbitkan kunci baru. Log penggunaan dibagi per halaman.
- Baru
Gambar dan dokumen dalam permintaan: bagian
image_urldi/v1/chat/completions, blokimage,document, danfiledi/v1/messages, bagianinput_imagedi/v1/responses. Gambar dan file - Baru
Model baru
shannon-3-pro. Model & harga
- Baru
Model baru
shannon-3. Model & harga - Baru
Stream di
/v1/chat/completionsmembawa penalaran sebagaidelta.reasoning_content. Reasoning effort
- Diubah
max_tokensdijaga dalam rentang 1 sampai 65,536. Nilai di luar rentang itu dibawa ke ujung terdekat, tidak ditolak. Chat Completions
- Baru
shannon-coder-1dihitung dalam jumlah panggilan per paket di/v1/chat/completionsdan/v1/messages. Ketika panggilan dalam satu jendela habis, balasannya429dengan pesanShannon Coder call quota reached. Tool coding CLI - Baru
Percakapan yang lebih besar daripada jendela konteks dijawab dengan
400, tipeinvalid_request_error, dan kodecontext_length_exceeded. Error di dalam stream tiba sebagai event error, bukan sebagai teks dalam jawaban. Tool coding CLI
- Baru
Endpoint
/v1:POST /v1/chat/completions,POST /v1/messages,POST /v1/responses, danGET /v1/models. Inilah endpoint yang dipanggil SDK OpenAI dan Anthropic, Claude Code, dan Codex CLI. Ringkasan - Baru
Panggilan tool dengan
toolsdi/v1/chat/completionsdan/v1/messages, output terstruktur denganresponse_format, dansystemsebagai string atau blok teks di/v1/messages. Pemanggilan fungsi
- Baru
Id model
shannon-1.6-pro,shannon-2-lite,shannon-2-pro, danshannon-coder-1, di sampingshannon-1.6-lite. Model & harga
- Baru
Rilis pertama API: chat dalam format OpenAI dan format Anthropic, serta endpoint Responses, masing-masing dipanggil dengan API key yang diawali
sk-. Autentikasi