Langsung ke konten
Catatan Perubahan

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: true menyebutkan sumbernya: sources pada /v1/chat/completions dan /v1/messages mencantumkan hasil yang diberikan kepada model, dan pada /v1/chat/completions, annotations menandai di mana jawaban mengutip masing-masing. Pencarian Web Terintegrasi

  • Baru

    web_search: true di /v1/chat/completions dan /v1/messages menjalankan 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-1 menjawab di /v1/responses seperti di dua endpoint lainnya. Tool coding CLI

  • Diperbaiki

    API key yang dirotasi langsung berhenti berfungsi.

  • Baru

    POST /v1/tokenize dan POST /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 usage pada ketiga endpoint: prompt_tokens_details.cached_tokens, input_tokens_details.cached_tokens, dan cache_read_input_tokens. GET /v1/models melaporkan pricing.cached_input_per_million_usd dan capabilities.prompt_caching untuk model-model ini. Prompt caching

  • Diperbaiki

    Model open-weight hosted: tool_choice yang dipaksakan (required atau fungsi bernama) menghasilkan panggilan tool. Pemanggilan fungsi

  • Diperbaiki

    Model open-weight hosted menerima pesan system yang bukan pesan pertama dalam percakapan.

  • Baru

    API dapat diakses sebagai layanan onion Tor dan di alamat I2P. Balasan api.shannon-ai.com membawa kedua alamat itu di header Onion-Location dan X-I2P-Location. Endpoint terenkripsi, Tor & I2P

  • Baru

    Model baru shannon-3.1 dan shannon-3.1-pro, tercantum di GET /v1/models. Model & harga

  • Diubah

    Permintaan streaming yang kliennya terputus dijalankan sampai selesai dan dihitung. Sebelumnya, jawaban berhenti saat terputus.

  • Diperbaiki

    Permintaan ke /v1/responses muncul di log penggunaan.

  • Baru

    Model open-weight hosted menerapkan field sampling: temperature, top_p, seed, stop, dan max_tokens di /v1/chat/completions; temperature, top_p, dan stop_sequences di /v1/messages; temperature, top_p, dan max_output_tokens di /v1/responses. Chat Completions

  • Baru

    Log penggunaan menampilkan biaya dalam USD untuk setiap panggilan dan sebagai total.

  • Perubahan merusak

    Nilai model yang bukan id yang dipublikasikan dijawab dengan 400, tipe invalid_request_error, dan pesan unknown model: <id> di ketiga endpoint. Sebelumnya, permintaan semacam itu dijawab oleh shannon-1.6-lite. Model & harga

  • Perubahan merusak

    /v1 hanya 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 dengan 503 dan tipe api_error. Penanganan kesalahan

  • Diperbaiki

    Permintaan tanpa streaming yang gagal mengembalikan cadangannya ke saldo Anda.

  • Baru

    GET /v1/models melaporkan capabilities.reasoning_effort untuk setiap model. Reasoning effort

  • Ditingkatkan

    Model open-weight hosted: permintaan tanpa streaming yang tidak mendapat jawaban berakhir dengan 504 dan tipe api_error. Hasil kosong adalah 502. 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 400 dan <id> does not accept image input. response_format pada id tanpa output terstruktur dijawab dengan 400. GET /v1/models melaporkan capabilities.vision, response_format, dan json_schema untuk setiap id. Gambar dan file

  • Diperbaiki

    Balasan tanpa streaming membawa teks penalaran: reasoning_content pada pesan di /v1/chat/completions, dan blok thinking sebelum 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, dan shannon-3.1-pro. GET /v1/models melaporkan capabilities.json_schema: true untuk model-model itu. Output Terstruktur

  • Baru

    /v1/responses membaca text.format (json_object atau json_schema) untuk output terstruktur. Responses API

  • Diperbaiki

    /v1/responses mengembalikan penalaran model Shannon: item output reasoning sebelum item message, serta event stream response.reasoning_summary_text.delta dan response.reasoning_summary_text.done. Responses API

  • Diperbaiki

    Field model pada balasan adalah id yang dipublikasikan di setiap endpoint. Objek Responses membawa model dan created_at.

  • Ditingkatkan

    GET /v1/models melaporkan jendela konteks setiap model. Model & harga

  • Baru

    Model open-weight hosted menjawab di /v1/messages dan /v1/responses selain di /v1/chat/completions, dengan system prompt dan panggilan tool Anda. /v1/messages menerima thinking, dan reasoning_effort adalah field permintaan. Model & harga

  • Ditingkatkan

    Isi error di /v1 mengikuti bentuk SDK: objek error dengan type dan message pada 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 : ping di /v1/chat/completions, event: ping di /v1/messages. Streaming

  • Diubah

    Id panggilan tool diawali call_ di /v1/chat/completions dan /v1/responses, serta toolu_ di /v1/messages. Pemanggilan fungsi

  • Perubahan merusak

    /v1/responses: default stream adalah false. Responses API

  • Baru

    max_completion_tokens diterima sebagai nama lain dari max_tokens di /v1/chat/completions. Chat Completions

  • Diperbaiki

    Event response.completed pada stream Responses membawa array output. Responses API

  • Baru

    Entri GET /v1/models membawa display_name, context_window, max_output_tokens, pricing, capabilities, dan endpoints. 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_url di /v1/chat/completions, blok image, document, dan file di /v1/messages, bagian input_image di /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/completions membawa penalaran sebagai delta.reasoning_content. Reasoning effort

  • Diubah

    max_tokens dijaga dalam rentang 1 sampai 65,536. Nilai di luar rentang itu dibawa ke ujung terdekat, tidak ditolak. Chat Completions

  • Baru

    shannon-coder-1 dihitung dalam jumlah panggilan per paket di /v1/chat/completions dan /v1/messages. Ketika panggilan dalam satu jendela habis, balasannya 429 dengan pesan Shannon Coder call quota reached. Tool coding CLI

  • Baru

    Percakapan yang lebih besar daripada jendela konteks dijawab dengan 400, tipe invalid_request_error, dan kode context_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, dan GET /v1/models. Inilah endpoint yang dipanggil SDK OpenAI dan Anthropic, Claude Code, dan Codex CLI. Ringkasan

  • Baru

    Panggilan tool dengan tools di /v1/chat/completions dan /v1/messages, output terstruktur dengan response_format, dan system sebagai string atau blok teks di /v1/messages. Pemanggilan fungsi

  • Baru

    Id model shannon-1.6-pro, shannon-2-lite, shannon-2-pro, dan shannon-coder-1, di samping shannon-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