Terakhir diperbarui
Panduan Integrasi API Mistral
Anda dapat mengganti API Mistral standar dengan alternatif uncensored kami hanya dengan memperbarui base URL dan kunci API. Panduan ini menjelaskan cara memigrasi kode OpenAI-compatible Anda yang ada untuk menjalankan model uncensored kami tanpa mengubah logika Anda.
Mengapa Beralih dari API Mistral Standar?
Pengembang sering menghadapi filter konten yang mengganggu alur kerja mereka. API standar menolak topik tertentu. Model tanpa sensor kami menjawab langsung. Anda memegang kendali penuh atas output Anda.
API Mistral standar andal. Ini melayani model populer. Namun, ini menerapkan lapisan moderasi sendiri. Anda mungkin melihat penolakan untuk tulisan kreatif atau tema dewasa. API kami menghilangkan hambatan itu. Ini menjalankan model bobot terbuka yang disesuaikan untuk pembatasan yang lebih sedikit. Anda mendapatkan endpoint kompatibel OpenAI yang sama.
Biaya adalah faktor lainnya. Paket standar sering kali mengunci Anda dalam langganan. Kami menggunakan sistem kredit pra-bayar. Anda hanya membayar untuk apa yang Anda gunakan. Error tidak memakan token Anda. Transparansi ini membantu Anda membuat anggaran dengan akurat.
Migrasi sepele. Kode yang ada Anda berfungsi. Anda hanya mengubah base URL. Tidak perlu penulisan ulang kompleks. Fleksibilitas ini cocok untuk pengembang yang ingin generasi tanpa sensor tanpa mengelola model lokal.
Langkah 1: Dapatkan Kunci API Anda
Mulai dengan membuat akun di platform kami. Anda dapat masuk dengan Google atau menggunakan email dan kata sandi. Tidak diperlukan nomor telepon. Ini menjaga identitas Anda tetap privat.
Setelah Anda masuk, buka dasbor. Hasilkan kunci API Anda segera. Kunci ditampilkan hanya sekali. Salin dan simpan dengan aman. Anda akan membutuhkannya untuk setiap permintaan.
Anda mendapatkan kredit uji coba secara otomatis. Akun baru mendapatkan $0.50 yang berlaku selama 7 hari. Ini memungkinkan Anda menguji integrasi sebelum menginvestasikan dana.
Kunci Anda memiliki batas tertentu. Anda dapat membuat 300 permintaan per menit. Hanya delapan permintaan yang berjalan secara bersamaan. Setiap kunci unik untuk akun Anda. Jika Anda membuat kunci baru, kunci lama akan berhenti berfungsi. Ini memastikan akses yang aman ke kredit Anda.
Langkah 2: Konfigurasi URL Dasar Anda
URL dasar adalah perubahan paling penting. Arahkan SDK Anda ke titik akhir kami. Gunakan format OpenAI standar. Ini memastikan kompatibilitas dengan pustaka yang ada.
Atur URL dasar Anda menjadi HTTPS://api.mistralbaseurl.com/v1. Jalur ini mencerminkan struktur penyedia utama. Kode Anda akan mengenali endpoint dengan benar. Anda tidak memerlukan driver atau klien baru.
Perbarui variabel kunci API Anda dalam kode Anda. Ganti kunci penyedia lama dengan kunci baru Anda. Pastikan string kunci benar. Salah ketik menyebabkan kesalahan autentikasi segera.
Uji koneksi dengan ping sederhana. Minta daftar model yang tersedia. Anda harus melihat model uncensored kami terdaftar. Ini mengonfigurasi bahwa konfigurasi Anda benar. Anda sekarang siap mengirim prompt.
Langkah 3: Terapkan Penyelesaian Chat
Kirim permintaan POST ke endpoint chat completions. Gunakan ID model "uncensored". Ini memicu model bahasa besar khusus kami. Ini memproses input Anda dan menghasilkan teks.
Strukturkan pesan Anda sebagai array. Sertakan peran sistem, pengguna, dan asisten. Model mengikuti instruksi ini dengan erat. Anda dapat menetapkan parameter seperti temperature dan top_p. Ini mengontrol kreativitas output.
Jendela konteks adalah 100.000 token. Ini memungkinkan dokumen panjang. Anda dapat mengirimkan konteks ekstensif dalam satu permintaan. Model mempertahankan koherensi atas urutan panjang. Ini berguna untuk analisis kode atau ringkasan.
Output maks adalah 16.000 token. Jika Anda tidak mengatur max_tokens, batasnya adalah 2.048. Sesuaikan parameter ini berdasarkan kebutuhan Anda. Respons yang lebih panjang memerlukan lebih banyak kredit. Rencanakan anggaran token Anda sesuai.
Menangani Streaming dan Token
Streaming meningkatkan pengalaman pengguna. Ini mengirim token saat dihasilkan. Ini mengurangi latensi yang dirasakan. Aktifkan streaming di pengaturan SDK Anda.
Kami menggunakan Server-Sent Events (SSE). Aliran menyediakan potongan teks. Setiap potongan berisi sebagian dari respons. Anda dapat menampilkan token secara real-time.
Penggunaan token dilaporkan dalam potongan terakhir. Ini memastikan penagihan yang akurat. Anda melihat persis apa yang dikonsumsi. Kesalahan tidak membebankan biaya kepada Anda. Penolakan gratis. Ini melindungi anggaran Anda dari permintaan yang terbuang.
Pantau saldo kredit Anda secara teratur. Anda dapat mengisi ulang melalui kripto kapan saja. Kredit tidak pernah kedaluwarsa. Ini memungkinkan Anda menghentikan penggunaan tanpa penalti. Anda mempertahankan saldo Anda secara tak terbatas.
Pemanggilan Fungsi dan Mode JSON
API kami mendukung output terstruktur. Anda dapat memaksakan mode JSON. Atur response_format ke json_object. Model hanya mengembalikan JSON yang valid. Ini sangat penting untuk integrasi.
Pemanggilan fungsi bekerja dengan mulus. Definisikan alat Anda dalam permintaan. Model mengidentifikasi alat mana yang akan digunakan. Model meneruskan argumen dengan benar. Anda dapat memparse hasilnya dalam kode Anda.
Atur tool_choice menjadi auto atau spesifik. Ini memberi Anda kontrol atas perilaku. Model memprioritaskan penggunaan alat ketika diperlukan. Ini meningkatkan keandalan dalam alur kerja kompleks.
Gunakan fitur ini untuk ekstraksi data. Otomatisasi formulir atau panggilan API. Model uncensored menangani kasus tepi dengan baik. Model tidak menolak pertanyaan kompleks. Ini membuatnya cocok untuk tugas produksi.
Kesalahan Umum: Penjelasan 404 dan 422
Kesalahan biasanya menunjukkan masalah konfigurasi. Kesalahan 404 Not Found umum terjadi. Ini berarti titik akhirnya salah. Periksa URL dasar Anda dengan hati-hati. Pastikan Anda menyertakan /v1 di jalur tersebut.
Kesalahan 422 Unprocessable Entity terjadi. Hal ini sering terjadi karena JSON yang tidak valid. Periksa struktur tubuh permintaan Anda. Pastikan semua bidang yang diperlukan ada. Verifikasi ID model benar.
Batas laju mengembalikan kesalahan 429. Anda telah melebihi 300 permintaan per menit. Tunggu sebentar sebelum mencoba lagi. Terapkan backoff eksponensial dalam kode Anda. Hal ini mencegah membanjiri API.
Periksa validitas kunci API Anda. Pastikan kunci tidak kedaluwarsa. Kunci diganti secara otomatis jika dibuat ulang. Gunakan kunci yang benar untuk setiap permintaan. Ini meminimalkan waktu henti.
Perbandingan Biaya: Mistral vs. API Uncensored Kami
Harga kami sederhana. Anda membayar $0.15 per juta token input. Token output berharga $0.50 per juta. Ini transparan dan dapat diprediksi.
API standar sering membebankan lebih banyak. Mereka mencakup biaya platform. Model kami berjalan di server kami. Anda membayar untuk komputasi secara langsung. Ini menurunkan biaya dasar.
Kesalahan gratis. Anda tidak membayar untuk permintaan yang gagal. Ini menghemat uang saat debugging. Anda hanya membayar untuk output yang valid.
Isi ulang dimulai dari $20. Anda membayar dengan crypto. Kredit bonus tersedia. Tambahkan $50 untuk tambahan 5%. Tambahkan $100 untuk tambahan 10%. Tambahkan $200 untuk tambahan 15%. Ini menghargai penggunaan yang lebih tinggi.
Pemeriksaan Akhir untuk Migrasi Lancar
Verifikasi URL dasar Anda benar. Perbarui kunci API Anda di lingkungan. Uji dengan prompt sederhana. Pastikan streaming berfungsi jika diperlukan.
Periksa penanganan batas laju Anda. Terapkan percobaan ulang untuk kesalahan 429. Pantau penggunaan token Anda. Sesuaikan max_tokens sesuai kebutuhan.
Aktifkan mode JSON untuk data terstruktur. Uji function calling dengan alat Anda. Pastikan model merespons dengan benar. Verifikasi format output sesuai dengan harapan Anda.
Sesuaikan parameter Anda. Atur suhu untuk kreativitas. Gunakan top_p untuk keragaman. Pengaturan ini memengaruhi kualitas output. Bereksperimenlah untuk menemukan keseimbangan terbaik. Kode Anda harus tetap tidak berubah kecuali untuk URL dan kunci.
