Dokumentasi API Mistral: Kesalahan Umum dan Perbaikan

Kesalahan 1: Mengasumsikan konteks tanpa batas tanpa memeriksa batas

Model ini mendukung jendela konteks 100.000 token, tetapi ini tidak tak terbatas. Anda harus memperhitungkan baik prompt maupun completion dalam total ini. Jika teks input Anda mendekati 84.000 token, model mungkin melakukan pemotongan atau menolak permintaan. Selalu pantau penggunaan token untuk tetap berada dalam batas keras 100.000 token.

Perhatikan penggunaan pustaka tokenizer dalam kode klien Anda untuk memperkirakan jumlah token sebelum mengirim permintaan. Ini mencegah pemborosan kredit pada payload yang ditolak. Streaming membantu mengelola memori, tetapi batas jendela konteks tetap ketat.

Kesalahan 2: Mengabaikan batasan badan permintaan 8 MB

Setiap body permintaan tidak boleh melebihi 8 MB. Batas ini berlaku untuk seluruh payload HTTP, termasuk struktur JSON dan metadata. Dokumen besar yang dikirim sebagai base64 atau teks mentah dapat dengan mudah melampaui batas ini. Bagi input Anda menjadi bagian-bagian yang lebih kecil jika Anda memproses dokumen panjang.

• Periksa ukuran payload Anda sebelum mengirim.
• Gunakan streaming untuk mengurangi tekanan memori.
• Kompres bidang yang tidak perlu dalam JSON Anda.

Mengabaikan kendala ini menghasilkan kesalahan 413 Payload Too Large. Men-debug masalah ini sering kali memerlukan memeriksa ukuran tubuh permintaan mentah. API kami memberlakukan ini secara ketat untuk menjaga kinerja.

Kesalahan 3: Mengharapkan moderasi standar di mana tidak ada

Karena model ini tidak disensor, model ini tidak menerapkan filter moderasi komersial standar. Model ini akan menghasilkan konten dewasa, kontroversial, atau fiksi tanpa penolakan. Namun, batas konten keras selalu berlaku: konten seksual yang melibatkan anak di bawah umur akan ditolak. Ini adalah aturan tetap, bukan pengaturan yang dapat dikonfigurasi.

Jangan mengasumsikan model akan melakukan sensor diri berdasarkan nada atau gaya. Model menjawab secara langsung. Jika Anda memerlukan moderasi, terapkan di lapisan aplikasi Anda sendiri. Ini memberi Anda kontrol penuh atas penyaringan konten tanpa bergantung pada penyedia API.

Kesalahan 4: Salah Memahami Siklus Penagihan Kripto Pra-dibayar

Tidak ada biaya bulanan atau langganan. Anda mengisi ulang dengan kripto, dan kredit dibebankan berdasarkan penggunaan token nyata. Kesalahan gratis, sehingga Anda hanya membayar penyelesaian yang berhasil. Kredit tidak pernah kedaluwarsa, sehingga Anda dapat mengisi ulang kapan saja.

Top-up berkisar dari $20 hingga $500 dalam jumlah bulat. Bonus berlaku: +5% dari $50, +10% dari $100, dan +15% dari $200. Pembayaran hanya diterima melalui USDT (TRC20) atau USDC (Base). Model ini transparan dan dapat diprediksi.

Kesalahan 5: Tidak menggunakan streaming untuk penyelesaian panjang

Penyelesaian panjang dapat memakan waktu signifikan. Tanpa streaming, klien Anda menunggu seluruh respons sebelum menampilkan apa pun. Ini mengarah pada pengalaman pengguna yang buruk dan potensi timeout. Gunakan Server-Sent Events (SSE) untuk menerima token saat mereka dihasilkan.

Streaming juga membantu mengelola penggunaan memori di sisi klien. Potongan terakhir menyertakan detail penggunaan token. Ini memungkinkan Anda melacak biaya secara real-time. Sesuaikan kode klien Anda untuk menangani stream SSE dengan benar.

Kesalahan 6: Lupa bahwa kesalahan itu gratis tetapi dihitung secara berbeda

Kesalahan tidak mengonsumsi token, sehingga Anda tidak membayar untuknya. Namun, kesalahan tersebut masih dihitung terhadap batas laju Anda. Jika Anda mengirim 300 permintaan per menit dan banyak yang gagal, Anda mungkin mencapai batas laju. Ini memblokir permintaan yang berhasil.

Implementasikan logika percobaan ulang dengan backoff eksponensial. Ini mencegah membanjiri API dengan permintaan gagal. Pantau tingkat kesalahan Anda untuk mengoptimalkan struktur payload. Kesalahan gratis adalah keuntungan, tetapi batas laju sangat ketat.

Kesalahan 7: Mengaburkan API ini dengan penyedia Mistral resmi

Ini adalah layanan independen. Kami bukan penyedia resmi Mistral. Kami menawarkan endpoint yang kompatibel dengan OpenAI yang menjalankan model tanpa sensor kami sendiri. URL dasar adalah HTTPS://api.mistralapidoc.com/v1. Jangan mengasumsikan bahwa harga atau batas resmi Mistral berlaku di sini.

Periksa dokumentasi resmi Mistral untuk model dan harga spesifik mereka. API kami dirancang untuk pengembang yang menginginkan output uncensored dengan kompatibilitas SDK standar. Kami tidak melayani model vendor lain. Model kami disesuaikan untuk konten dewasa dan tidak memiliki moderasi standar.

Dokumentasi API Mistral: Daftar Periksa Migrasi

Sebelum memigrasi kode Anda, verifikasi URL dasar dan kunci API Anda. Gunakan SDK OpenAI resmi dengan endpoint kami. Atur ID model ke "uncensored". Uji dengan payload kecil terlebih dahulu. Pastikan klien Anda menangani aliran SSE dengan benar.

• Perbarui base_url ke endpoint kami.
• Atur model ke "uncensored".
• Implementasikan streaming untuk output panjang.
• Pantau penggunaan token dan kesalahan.

Daftar periksa ini memastikan transisi yang lancar. API kami kompatibel dengan klien OpenAI standar. Tidak ada vendor lock-in. Cukup ubah base URL dan kunci. Mulai dengan kredit uji coba untuk memverifikasi fungsionalitas.