Panduan multimodal Kimi K3: apa yang boleh dan tidak boleh disahkan daripada config

Kimi K3 dan Moonshot ialah dua keluarga model terbuka China yang melalui laluan berbeza: satu menekankan the cloud catalog, satu lagi menekankan local weights. Artikel ini membandingkan struktur keluarga, quantization rasmi, ekosistem komuniti dan laluan penggunaan sebenar; semua angka disahkan melalui HuggingFace API dan konfigurasi rasmi

Jadual perbandingan

Perbezaan paling ketara terletak pada format berat: hy4 daripada Hunyuan ialah satu-satunya model 4B kelas China yang sumbernya mengeluarkan FP8, GPTQ-Int4 dan AWQ-Int4 serentak, manakala kebanyakan keluarga lain hanya memberi FP8 lalu menyerahkan kerja 4-bit kepada komuniti. Mempunyai kedua-dua GPTQ dan AWQ bermakna anda boleh mengukur pada stack sendiri kemudian memilih

Jarak penerimaan sebenar dalam komuniti juga menjadi penunjuk jelas: 751,953 downloads for Kimi-K3 and 393,277 for K2.5 Angka-angka ini ialah muat turun 30 hari daripada HuggingFace yang menggambarkan saiz komuniti dan peluang mencari fail GGUF yang sepadan dengan perkakasan, bukan ukuran kualiti model, namun dalam produksi ia memberi kesan langsung kepada masa menyelesaikan masalah

Untuk pemasangan: hy4 menggunakan FP8 atau GPTQ-Int4 rasmi bersama vLLM, atau GGUF Q4_K_M 2.61GB daripada komuniti bersama llama.cpp dan Ollama pada kad 6GB malah CPU. A13B ialah MoE 80.39 bilion parameter justeru memerlukan berbilang kad atau CPU offload, dan mempunyai GGUF rasmi Q4_K_M 48.8GB

Verified facts versus claims that need measurement

Soalan yang lebih bernilai bukan siapa lebih kuat tetapi apa yang kerja anda perlukan: perlukan alatan, dokumentasi dan pilihan sedia ada maka ikut Kimi K3; perlukan kawalan ke atas berat, quantization dan data kekal dalam mesin maka ikut Moonshot. Banyak sistem menggunakan kedua-duanya dengan membahagikan aliran mengikut jenis tugas

Pilih mengikut senario

Pengendalian ralat yang kerap berlaku

Gejala pertama ialah 401 Unauthorized, hampir selalu kerana kunci tamat tempoh, header salah, atau terlupa prefiks Bearer; ambil nilai terkini daripada konsol lalu uji dengan permintaan pendek sebelum menyalahkan model. Seterusnya ialah 404 atau mesej model tidak dijumpai, yang bermakna ID yang dihantar tiada dalam katalog pada masa itu; buka halaman /models untuk melihat nama sebenar lalu betulkan medan model. Kod 429 ialah had kadar, jadi tambahkan exponential backoff dan asingkan permintaan yang selamat diulang daripada yang tidak boleh diulang

Untuk streaming, ingat bahawa hasilnya tiba dalam bentuk cebisan bukan teks lengkap; pihak client mesti mencantumkan cebisan itu dan mengendalikan kes chunk terakhir tanpa content. Untuk tool calling, gunakan format OpenAI tepat; jika alat tidak dipanggil, puncanya biasanya huraian fungsi kurang jelas atau system prompt belum membenarkan penggunaan alat, bukan had model

Kos, kuota dan perkara penting

Panggilan dikira daripada jumlah token masukan dan keluaran, bukan daripada bilangan request, jadi memasukkan seluruh dokumen panjang setiap kali akan menaikkan kos dengan pantas. Cara yang disyorkan ialah memotong atau meringkaskan bahagian tidak berkaitan sebelum menghantar, dan mengaktifkan streaming hanya di tempat pengguna memang perlu melihat hasil serta-merta. Harga serta pakej kredit semasa sentiasa rujuk halaman /pricing kerana angka dalam mana-mana artikel boleh menjadi lapuk

Sebaiknya simpan cache hasil untuk soalan berulang, serta catat log mengandungi ID model, jumlah token dan masa respons sebagai dataset untuk semakan semula kemudian. Apabila menukar model daripada kimi-k3 kepada glm-5.3-flash atau sebaliknya, jalankan semula set ujian yang sama kerana tingkah laku panggilan alat dan panjang jawapan berbeza, walaupun format permintaannya serupa sepenuhnya

Senarai semak sebelum produksi

Tiga perkara yang paling kerap terlepas ketika berpindah daripada ujian kepada penggunaan harian.

Pertama, simpan versi fail GGUF bersama tarikh penukarannya. Komuniti terus mengeluarkan pembaikan penukaran, dan tanpa catatan itu anda tidak boleh kembali kepada versi yang sudah terbukti stabil apabila keluaran baharu ternyata menurunkan kualiti. Catat juga nama penerbit, kerana dua fail bernama Q4_K_M daripada penerbit berbeza bukanlah barangan yang sama.

Kedua, ukur penggunaan memori pada beban sebenar, bukan sekadar daripada formula. Angka hasil pengiraan hanyalah anggaran; pada beban sebenar memori sering naik kerana penimbal tambahan, baris gilir kelompok, dan konteks yang lebih panjang daripada jangkaan. Jalankan tiga kali dengan prompt yang sama, ambil nilai tengah, dan simpan angka puncak daripada nvidia-smi sebagai penanda aras.

Ketiga, sediakan laluan sandaran. Untuk perkhidmatan dalaman, sediakan model ringan lain yang boleh mengambil alih apabila hy4 sibuk atau sedang dimuatkan semula. Lapisan penghalaan ringkas ini biasanya jauh lebih murah daripada memaksa satu model menanggung semua trafik, dan pada masa yang sama memberi ruang untuk menguji quantization baharu tanpa menghentikan perkhidmatan.

Selain tiga perkara itu, biasakan menyemak templat perbualan setiap kali menukar versi model. Templat yang tidak sepadan tetap menghasilkan token yang kelihatan lancar tetapi jawabannya menyimpang, dan gejalanya sering disalah diagnosis sebagai berat yang rosak. Menyimpan templat bersama fail GGUF dalam satu folder yang sama menjadikan proses ini jauh lebih mudah diaudit.

Nota istilah dan unit

Beberapa istilah dalam panduan ini sering tertukar, jadi elok diselaraskan sejak awal. Parameter jumlah ialah keseluruhan berat yang mesti dimuatkan ke memori, manakala parameter aktif ialah bahagian yang turut mengira setiap token; pada model MoE kedua-duanya boleh berbeza satu tertib magnitud. KV cache ialah memori tambahan yang tumbuh secara linear mengikut panjang konteks, bukan mengikut bilangan parameter. Quantization ialah proses menurunkan ketepatan berat supaya fail lebih kecil, bukan proses mengecilkan bilangan parameter.

Unit yang digunakan: GB di sini ialah saiz fail hasil pengukuran pada repositori, jadi angkanya boleh sedikit berbeza daripada hasil darab parameter dengan byte per parameter kerana ada metadata dan sebahagian lapisan yang kekal disimpan pada ketepatan lebih tinggi. Token ialah unit teks yang diproses model, dan satu token bahasa Inggeris secara purata kira-kira empat aksara, manakala satu aksara Cina biasanya menghampiri satu token. Semua angka muat turun yang disebut ialah pembilang awam 30 hari daripada HuggingFace, bukan bilangan pengguna aktif.

Akhir sekali, bezakan nama berat di HuggingFace dengan ID model dalam katalog platform. Nama berat digunakan ketika memuat turun dan memuatkan model secara tempatan; ID katalog digunakan ketika memanggil API. Kedua-duanya ialah dua sistem penamaan yang berbeza, dan mencampurkannya ialah punca kesilapan yang paling kerap muncul apabila kali pertama menyambungkan model tempatan kepada aplikasi sedia ada.

FAQ

Bacaan lanjutan

• Panduan API Kimi K3 — first API call
• Panduan konteks panjang Kimi K3 — 1M context practice
• Penerapan berat terbuka Kimi K3 — local weights
• Integrasi alat Kimi K3 — editor and platform setup
• hy4 dan Kimi — lightweight versus flagship

Sumber data

• moonshotai on HuggingFace
• Kimi-K3 config on HuggingFace

Angka parameter dan saiz fail daripada HuggingFace API serta konfigurasi rasmi, disampel November 2026

Senarai semak pemasangan tempatan

Semua angka tentang The Complete Local Deployment Playbook: Seven Steps from Hardware Check to Workflow Integration pada halaman ini disahkan terus terhadap HuggingFace API dan config.json asal repositori berkenaan, disampel November 2026. Tiada skor penanda aras, harga atau nama repositori yang direka; apa sahaja yang tidak dapat dibuktikan config ditanda sebagai perlu diukur sendiri.

Spesifikasi terverifikasi

Reference table

Reference table

Apa yang boleh disahkan angka

Pemisahan fakta daripada dakwaan paling penting untuk bahasa multimodal. vision_config dan image_placeholder dalam config rasmi hanya membuktikan seni bina conditional generation yang boleh menerima imej; ia tidak dengan sendirinya membuktikan penjanaan video, format permintaan tertentu atau sebarang skor penanda aras. Tag image-text-to-text HuggingFace menerangkan arah input. Sentiasa jadikan model card rasmi sebagai sumber terakhir.

Configuration and troubleshooting

Perancangan memori bagi MoE trilion parameter memakai aturan sama: pengkomputan mengikut parameter aktif manakala memori mengikut jumlah parameter. Model 1T pada 4-bit masih memerlukan kira-kira 500GB untuk berat sahaja, dan versi 2.78T lebih besar lagi, jadi ini beban pelayan berbilang kad bukan satu kad pengguna. Untuk satu kad, lihat keluarga ringan. Laluan tempatan ialah vLLM atau SGLang dengan berat rasmi, dan penukaran komuniti perlu disemak sumber serta label quantization dahulu.

Batas penggunaan

Pada EXAIV, katalog /models masa nyata ialah rujukan: kini hanya kimi-k3 boleh dipanggil, melalui endpoint serasi OpenAI di https://exaiv.com/api/ai/v1. Integrasi hanya menukar base_url, api_key dan model; streaming serta tool calling mengekalkan format OpenAI standard. Harga sentiasa mengikut halaman /pricing dan tidak ditulis mati di sini. Simpan log mengandungi ID model, jumlah token dan kependaman supaya pertukaran model kemudian mempunyai garis asas sama.

Pengendalian ralat yang kerap berlaku

Gejala pertama ialah 401 Unauthorized, hampir selalu kerana kunci tamat tempoh, header salah, atau terlupa prefiks Bearer; ambil nilai terkini daripada konsol lalu uji dengan permintaan pendek sebelum menyalahkan model. Seterusnya ialah 404 atau mesej model tidak dijumpai, yang bermakna ID yang dihantar tiada dalam katalog pada masa itu; buka halaman /models untuk melihat nama sebenar lalu betulkan medan model. Kod 429 ialah had kadar, jadi tambahkan exponential backoff dan asingkan permintaan yang selamat diulang daripada yang tidak boleh diulang

Untuk streaming, ingat bahawa hasilnya tiba dalam bentuk cebisan bukan teks lengkap; pihak client mesti mencantumkan cebisan itu dan mengendalikan kes chunk terakhir tanpa content. Untuk tool calling, gunakan format OpenAI tepat; jika alat tidak dipanggil, puncanya biasanya huraian fungsi kurang jelas atau system prompt belum membenarkan penggunaan alat, bukan had model

Kos, kuota dan perkara penting

Panggilan dikira daripada jumlah token masukan dan keluaran, bukan daripada bilangan request, jadi memasukkan seluruh dokumen panjang setiap kali akan menaikkan kos dengan pantas. Cara yang disyorkan ialah memotong atau meringkaskan bahagian tidak berkaitan sebelum menghantar, dan mengaktifkan streaming hanya di tempat pengguna memang perlu melihat hasil serta-merta. Harga serta pakej kredit semasa sentiasa rujuk halaman /pricing kerana angka dalam mana-mana artikel boleh menjadi lapuk

Sebaiknya simpan cache hasil untuk soalan berulang, serta catat log mengandungi ID model, jumlah token dan masa respons sebagai dataset untuk semakan semula kemudian. Apabila menukar model daripada kimi-k3 kepada glm-5.3-flash atau sebaliknya, jalankan semula set ujian yang sama kerana tingkah laku panggilan alat dan panjang jawapan berbeza, walaupun format permintaannya serupa sepenuhnya

Senarai semak sebelum produksi

Tiga perkara yang paling kerap terlepas ketika berpindah daripada ujian kepada penggunaan harian.

Pertama, simpan versi fail GGUF bersama tarikh penukarannya. Komuniti terus mengeluarkan pembaikan penukaran, dan tanpa catatan itu anda tidak boleh kembali kepada versi yang sudah terbukti stabil apabila keluaran baharu ternyata menurunkan kualiti. Catat juga nama penerbit, kerana dua fail bernama Q4_K_M daripada penerbit berbeza bukanlah barangan yang sama.

Kedua, ukur penggunaan memori pada beban sebenar, bukan sekadar daripada formula. Angka hasil pengiraan hanyalah anggaran; pada beban sebenar memori sering naik kerana penimbal tambahan, baris gilir kelompok, dan konteks yang lebih panjang daripada jangkaan. Jalankan tiga kali dengan prompt yang sama, ambil nilai tengah, dan simpan angka puncak daripada nvidia-smi sebagai penanda aras.

Ketiga, sediakan laluan sandaran. Untuk perkhidmatan dalaman, sediakan model ringan lain yang boleh mengambil alih apabila hy4 sibuk atau sedang dimuatkan semula. Lapisan penghalaan ringkas ini biasanya jauh lebih murah daripada memaksa satu model menanggung semua trafik, dan pada masa yang sama memberi ruang untuk menguji quantization baharu tanpa menghentikan perkhidmatan.

Selain tiga perkara itu, biasakan menyemak templat perbualan setiap kali menukar versi model. Templat yang tidak sepadan tetap menghasilkan token yang kelihatan lancar tetapi jawabannya menyimpang, dan gejalanya sering disalah diagnosis sebagai berat yang rosak. Menyimpan templat bersama fail GGUF dalam satu folder yang sama menjadikan proses ini jauh lebih mudah diaudit.

Nota istilah dan unit

Beberapa istilah dalam panduan ini sering tertukar, jadi elok diselaraskan sejak awal. Parameter jumlah ialah keseluruhan berat yang mesti dimuatkan ke memori, manakala parameter aktif ialah bahagian yang turut mengira setiap token; pada model MoE kedua-duanya boleh berbeza satu tertib magnitud. KV cache ialah memori tambahan yang tumbuh secara linear mengikut panjang konteks, bukan mengikut bilangan parameter. Quantization ialah proses menurunkan ketepatan berat supaya fail lebih kecil, bukan proses mengecilkan bilangan parameter.

Unit yang digunakan: GB di sini ialah saiz fail hasil pengukuran pada repositori, jadi angkanya boleh sedikit berbeza daripada hasil darab parameter dengan byte per parameter kerana ada metadata dan sebahagian lapisan yang kekal disimpan pada ketepatan lebih tinggi. Token ialah unit teks yang diproses model, dan satu token bahasa Inggeris secara purata kira-kira empat aksara, manakala satu aksara Cina biasanya menghampiri satu token. Semua angka muat turun yang disebut ialah pembilang awam 30 hari daripada HuggingFace, bukan bilangan pengguna aktif.

Akhir sekali, bezakan nama berat di HuggingFace dengan ID model dalam katalog platform. Nama berat digunakan ketika memuat turun dan memuatkan model secara tempatan; ID katalog digunakan ketika memanggil API. Kedua-duanya ialah dua sistem penamaan yang berbeza, dan mencampurkannya ialah punca kesilapan yang paling kerap muncul apabila kali pertama menyambungkan model tempatan kepada aplikasi sedia ada.

Istilah dan senarai semak sebelum produksi

Jumlah parameter, parameter aktif dan KV cache ialah tiga kuantiti berbeza. Jumlah parameter ialah keseluruhan berat yang mesti dimuatkan ke memori; parameter aktif ialah bahagian yang mengira satu token. KV cache ialah memori sementara yang tumbuh secara linear mengikut panjang konteks, jadi tetingkap 1M ialah siling bukan lalai percuma. Quantization menurunkan ketepatan berat yang disimpan supaya fail mengecil, bukan mengurangkan bilangan parameter. vision_config dalam config.json menerangkan seni bina, bukan format permintaan yang boleh anda mereka sendiri.

Sebelum membawa apa-apa yang dibina daripada nota ini ke produksi, jalankan enam semakan. Baca semula angka daripada sumber langsung pada hari anda menerbitkan kerana pembilang muat turun berubah setiap minggu. Buka katalog /models masa nyata dan sahkan ID yang hendak dipanggil masih ada. Buka /pricing dan bukannya menyalin harga ke dalam aplikasi. Jangan sekali-kali menulis request body secara kekal sebelum mengesahkannya terhadap rujukan rasmi. Catat ID model, jumlah token masukan keluaran dan kependaman pada satu set prompt wakil lalu kekalkan set itu supaya pertukaran model kemudian menghasilkan bacaan boleh banding. Baca lesen pada model card sebelum kegunaan komersial kerana terma vendor bukan lalai permisif. Tambah exponential backoff untuk permintaan selamat diulang, tetapkan timeout dan catat log mengikut kelas ralat supaya 401, 404 dan 429 tidak pernah dilayan sama. Sediakan juga laluan putaran kunci: jangan simpan key dalam repositori, dan sediakan pelan rollback apabila berpindah ke sistem pengurusan kunci. Jika model boleh dimuat tetapi keluaran bercelaru, syaki templat perbualan sebelum menyalahkan berat; simpan templat bersebelahan dengan berat supaya mudah diaudit bersama. Kebiasaan ini hanya beberapa minit tetapi menghalang kelas laporan pepijat silap yang paling kerap muncul.

FAQ

Bacaan lanjutan

• Kimi K3 API guide — first API call
• GLM family overview — callable catalog
• hy4 model selection guide — sizing and selection
• Claude Code third-party models — support boundary
• pricing — live credit packs

Sumber data

• EXAIV live model catalog

Data parameter dan fail disampel November 2026 dan boleh