Langkau ke kandungan
Log perubahan

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: true menamakan sumbernya: sources pada /v1/chat/completions dan /v1/messages menyenaraikan hasil yang diberikan kepada model, dan pada /v1/chat/completions annotations menandakan tempat jawapan memetik setiap satu. Carian Web Terbina dalam

  • baru

    web_search: true pada /v1/chat/completions dan /v1/messages menjalankan 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-1 menjawab pada /v1/responses seperti pada dua endpoint yang lain. Alat pengekodan CLI

  • tetap

    Kunci API yang diputar berhenti berfungsi serta-merta.

  • baru

    POST /v1/tokenize dan POST /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 usage pada ketiga-tiga 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 ini. Caching prompt

  • tetap

    Model open-weight yang dihoskan: tool_choice yang dipaksa (required atau fungsi bernama) menghasilkan panggilan alat. Panggilan Fungsi

  • tetap

    Model open-weight yang dihoskan menerima mesej system yang bukan mesej pertama perbualan.

  • baru

    API boleh dicapai sebagai perkhidmatan onion Tor dan pada alamat I2P. Balasan api.shannon-ai.com membawa kedua-dua alamat dalam header Onion-Location dan X-I2P-Location. Endpoint disulitkan, Tor & I2P

  • baru

    Model baharu shannon-3.1 dan shannon-3.1-pro, disenaraikan oleh GET /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/responses muncul dalam log penggunaan.

  • baru

    Model open-weight yang dihoskan melaksanakan medan persampelan: temperature, top_p, seed, stop dan max_tokens pada /v1/chat/completions; temperature, top_p dan stop_sequences pada /v1/messages; temperature, top_p dan max_output_tokens pada /v1/responses. Chat Completions

  • baru

    Log penggunaan menunjukkan kos dalam USD bagi setiap panggilan dan sebagai jumlah.

  • Berbuka

    Nilai model yang bukan id yang diterbitkan dijawab dengan 400, jenis invalid_request_error dan mesej unknown model: <id> pada ketiga-tiga endpoint. Sebelum ini, permintaan sedemikian dijawab oleh shannon-1.6-lite. Model & harga

  • Berbuka

    /v1 hanya 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 dengan 503 dan jenis api_error. Pengendalian Ralat

  • tetap

    Permintaan bukan stream yang gagal memulangkan tempahannya kepada baki anda.

  • baru

    GET /v1/models melaporkan capabilities.reasoning_effort bagi setiap model. Usaha penaakulan

  • bertambah baik

    Model open-weight yang dihoskan: permintaan bukan stream yang tidak mendapat jawapan berakhir dengan 504 dan jenis api_error. Hasil kosong ialah 502. 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 400 dan <id> does not accept image input. response_format pada id tanpa output berstruktur dijawab dengan 400. GET /v1/models melaporkan capabilities.vision, response_format dan json_schema bagi setiap id. Imej dan fail

  • tetap

    Balasan bukan stream membawa teks penaakulan: reasoning_content pada mesej /v1/chat/completions, dan blok thinking sebelum 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.1 dan shannon-3.1-pro. GET /v1/models melaporkan capabilities.json_schema: true untuknya. Output Berstruktur

  • baru

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

  • tetap

    /v1/responses memulangkan penaakulan model Shannon: item output reasoning sebelum item message, dan peristiwa stream response.reasoning_summary_text.delta dan response.reasoning_summary_text.done. API Responses

  • tetap

    Medan model dalam balasan ialah id yang diterbitkan pada setiap endpoint. Objek Responses membawa model dan created_at.

  • bertambah baik

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

  • baru

    Model open-weight yang dihoskan menjawab pada /v1/messages dan /v1/responses serta pada /v1/chat/completions, dengan system prompt dan panggilan alat anda. /v1/messages menerima thinking, dan reasoning_effort ialah medan permintaan. Model & harga

  • bertambah baik

    Badan ralat pada /v1 mengikut bentuk SDK: objek error dengan type dan message pada 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 : ping pada /v1/chat/completions, event: ping pada /v1/messages. Penstriman

  • Diubah

    Id panggilan alat bermula dengan call_ pada /v1/chat/completions dan /v1/responses, dan dengan toolu_ pada /v1/messages. Panggilan Fungsi

  • Berbuka

    /v1/responses: stream lalai kepada false. API Responses

  • baru

    max_completion_tokens diterima sebagai nama lain bagi max_tokens pada /v1/chat/completions. Chat Completions

  • tetap

    Peristiwa response.completed bagi stream Responses membawa tatasusunan output. API Responses

  • 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 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_url pada /v1/chat/completions, blok image, document dan file pada /v1/messages, bahagian input_image pada /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/completions membawa penaakulan sebagai delta.reasoning_content. Usaha penaakulan

  • Diubah

    max_tokens dikekalkan dalam lingkungan 1 hingga 65,536. Nilai di luar julat itu dibawa ke hujung yang terdekat, bukan ditolak. Chat Completions

  • baru

    shannon-coder-1 dikira dalam panggilan bagi setiap pelan pada /v1/chat/completions dan /v1/messages. Apabila panggilan sesuatu tetingkap habis digunakan, balasannya ialah 429 dengan mesej Shannon Coder call quota reached. Alat pengekodan CLI

  • baru

    Perbualan yang lebih besar daripada tetingkap konteks dijawab dengan 400, jenis invalid_request_error dan kod context_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/responses dan GET /v1/models. Ia ialah endpoint yang dipanggil oleh SDK OpenAI dan Anthropic, Claude Code dan Codex CLI. Gambaran keseluruhan

  • baru

    Panggilan alat dengan tools pada /v1/chat/completions dan /v1/messages, output berstruktur dengan response_format, dan system sebagai rentetan atau sebagai blok teks pada /v1/messages. Panggilan 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

    Keluaran pertama API: sembang dalam format OpenAI dan format Anthropic, serta endpoint Responses, masing-masing dipanggil dengan kunci API yang bermula dengan sk-. Pengesahan