Kemas kini terakhir
Panduan Integrasi API Mistral
Anda boleh menggantikan API Mistral standard dengan alternatif tanpa sensor kami hanya dengan mengemas kini URL asas dan kunci API. Panduan ini menerangkan cara mengemigrasikan kod serasi OpenAI sedia ada anda untuk menjalankan model tanpa sensor kami tanpa mengubah logik anda.
Mengapa Tukar Dari API Mistral Standard?
Pembangun sering menghadapi tapisan kandungan yang mengganggu aliran kerja mereka. API standard menolak topik tertentu. Model tanpa sensor kami menjawab secara langsung. Anda mengekalkan kawalan penuh ke atas output anda.
API Mistral standard adalah boleh dipercayai. Ia melayani model popular. Walau bagaimanapun, ia menerapkan lapisan penapisan sendiri. Anda mungkin melihat penolakan untuk penulisan kreatif atau tema dewasa. API kami membuang halangan tersebut. Ia menjalankan model berat terbuka yang diselaraskan untuk fewer sekatan. Anda mendapat hujung jauh serasi OpenAI yang sama.
Kos adalah faktor lain. Pelan standard sering mengunci anda dalam langganan. Kami menggunakan sistem kredit pra-bayar. Anda hanya membayar untuk apa yang anda gunakan. Ralat tidak menelan belanja token anda. Ketelusan ini membantu anda bajet dengan tepat.
Peralihan mudah. Kod sedia ada anda berfungsi. Anda hanya mengubah URL asas. Tiada penulisan semula kompleks diperlukan. Fleksibiliti ini sesuai untuk pembangun yang mahu penjanaan tanpa sensor tanpa mengurus model tempatan.
Langkah 1: Dapatkan Kunci API Anda
Mula dengan mencipta akaun di platform kami. Anda boleh log masuk dengan Google atau menggunakan e-mel dan kata laluan. Tiada nombor telefon diperlukan. Ini mengekalkan privasi identiti anda.
Setelah anda log masuk, navigasikan ke papan pemuka. Jana kunci API anda serta-merta. Kunci ditunjukkan hanya sekali. Salin dan simpan dengan selamat. Anda akan memerlukannya untuk setiap permintaan.
Anda menerima kredit percubaan secara automatik. Akaun baharu mendapat $0.50 yang sah selama 7 hari. Ini membolehkan anda menguji integrasi sebelum mengikat dana.
Kunci anda mempunyai had tertentu. Anda boleh membuat 300 permintaan setiap minit. Hanya lapan permintaan dijalankan serentak. Setiap kunci adalah unik untuk akaun anda. Jika anda menjana kunci baru, kunci lama akan berhenti berfungsi. Ini memastikan akses yang selamat kepada kredit anda.
Langkah 2: Konfigurasikan URL Asas Anda
URL asas adalah perubahan paling penting. Arahkan SDK anda ke titik akhir kami. Gunakan format OpenAI piawai. Ini memastikan keserasian dengan perpustakaan sedia ada anda.
Tetapkan URL asas anda kepada HTTPS://api.mistralbaseurl.com/v1. Laluan ini meniru struktur penyedia utama. Kod anda akan mengenali hujung titik dengan betul. Anda tidak memerlukan pemacu atau klien baharu.
Kemas kini pembolehubah kunci API anda dalam kod anda. Gantikan kunci penyedia lama dengan yang baru. Pastikan rentetan kunci betul. Kesilapan taip menyebabkan ralat pengesahan serta-merta.
Uji sambungan dengan ping mudah. Minta senarai model yang tersedia. Anda sepatutnya melihat model tanpa sensor kami disenaraikan. Ini mengesahkan konfigurasi anda adalah betul. Anda kini sedia untuk menghantar prompt.
Langkah 3: Laksanakan Penyelesaian Sembang
Hantar permintaan POST ke hujung akhir penyelesaian sembang. Gunakan ID model "uncensored". Ini mencetuskan model bahasa besar khusus kami. Ia memproses input anda dan menjana teks.
Struktur mesej anda sebagai satu larik. Sertakan peranan sistem, pengguna, dan pembantu. Model mengikuti arahan ini dengan rapat. Anda boleh menetapkan parameter seperti suhu dan top_p. Ini mengawal kreativiti output.
Tingkap konteks ialah 100,000 token. Ini membolehkan dokumen panjang. Anda boleh menghantar konteks yang luas dalam satu permintaan. Model mengekalkan koherensi merentasi jujukan panjang. Ini berguna untuk analisis kod atau ringkasan.
Output maks ialah 16,000 token. Jika anda tidak menetapkan max_tokens, hadnya ialah 2,048. Laraskan parameter ini berdasarkan keperluan anda. Respons yang lebih panjang memerlukan lebih banyak kredit. Rancang bajet token anda dengan sewajarnya.
Mengendalikan Aliran dan Token
Penstriman meningkatkan pengalaman pengguna. Ia menghantar token sejajar dengan penjanaan. Ini mengurangkan latensi yang dirasakan. Aktifkan penstriman dalam tetapan SDK anda.
Kami menggunakan Server-Sent Events (SSE). Aliran menyediakan pecahan teks. Setiap pecahan mengandungi sebahagian daripada respons. Anda boleh memaparkan token secara masa nyata.
Penggunaan token dilaporkan dalam segmen akhir. Ini memastikan bil yang tepat. Anda melihat tepat apa yang digunakan. Ralat tidak menjejaki caj anda. Penolakan adalah percuma. Ini melindungi bajet anda daripada permintaan yang sia-sia.
Pantau baki kredit anda secara berkala. Anda boleh menambah dana melalui kripto pada bila-bila masa. Kredit tidak luput. Ini membolehkan anda menghentikan penggunaan tanpa penalti. Anda mengekalkan baki anda secara kekal.
Panggilan Fungsi dan Mod JSON
API kami menyokong output terstruktur. Anda boleh memaksa mod JSON. Tetapkan response_format kepada json_object. Model hanya mengembalikan JSON yang sah. Ini sangat penting untuk integrasi.
Pemanggilan fungsi berfungsi dengan lancar. Takrifkan alat anda dalam permintaan. Model mengenal pasti alat mana yang digunakan. Ia menghantar hujah dengan betul. Anda boleh menguraikan keputusan dalam kod anda.
Tetapkan tool_choice kepada auto atau khusus. Ini memberi anda kawalan ke atas tingkah laku. Model ini mengutamakan penggunaan alat apabila diperlukan. Ini meningkatkan kebolehpercayaan dalam aliran kerja kompleks.
Gunakan ciri-ciri ini untuk pengekstrakan data. Automatkan borang atau panggilan API. Model tanpa sensor mengendalikan kes tepi dengan baik. Ia tidak menolak pertanyaan kompleks. Ini menjadikannya sesuai untuk tugas pengeluaran.
Ralat Biasa: 404 dan 422 Dijelaskan
Kesalahan biasanya menunjukkan isu konfigurasi. Ralat 404 Not Found adalah biasa. Ia bermaksud hujung titik salah. Semak URL asas anda dengan teliti. Pastikan anda termasuk /v1 dalam laluan.
Kesilapan 422 Unprocessable Entity berlaku. Ini sering berlaku dengan JSON yang tidak sah. Semak struktur badan permintaan anda. Pastikan semua medan yang diperlukan ada. Sahkan ID model adalah betul.
Had kadar mengembalikan ralat 429. Anda telah melebihi 300 permintaan setiap minit. Tunggu sebentar sebelum cuba semula. Laksanakan penangguhan eksponen dalam kod anda. Ini mencegah API daripada dibebani berlebihan.
Semak kesahihan kekunci API anda. Pastikan ia tidak luput. Kekunci digantikan secara automatik jika dijana semula. Gunakan kekunci yang betul untuk setiap permintaan. Ini meminimumkan masa henti.
Perbandingan Kos: Mistral vs. API Tanpa Sensor Kami
Harga kami adalah mudah. Anda membayar $0.15 per satu juta token input. Token output berharga $0.50 per satu juta. Ini adalah telus dan boleh diramal.
API standard sering mengenakan caj lebih tinggi. Mereka termasuk yuran platform. Model kami berjalan di pelayan kami. Anda membayar untuk pengkomputeran secara langsung. Ini menurunkan kos asas.
Kesalahan adalah percuma. Anda tidak membayar untuk permintaan yang gagal. Ini menjimatkan wang semasa nyahpepijat. Anda hanya membayar untuk output yang sah.
Top-up bermula pada $20. Anda membayar dengan kriptokoin. Kredit bonus tersedia. Tambah $50 untuk tambahan 5%. Tambah $100 untuk tambahan 10%. Tambah $200 untuk tambahan 15%. Ini memberi ganjaran kepada penggunaan yang lebih tinggi.
Senarai Semak Akhir untuk Penghijrahan Lancar
Sahkan URL asas anda adalah betul. Kemas kini kunci API anda dalam persekitaran. Uji dengan prompt mudah. Pastikan penstriman berfungsi jika diperlukan.
Semak pengendalian had kadar anda. Laksanakan percubaan semula untuk ralat 429. Pantau penggunaan token anda. Larangkan max_tokens jika perlu.
Dayakan mod JSON untuk data terstruktur. Ujikan pemanggilan fungsi dengan alat anda. Pastikan model memberi respons dengan betul. Verifikasi format output memenuhi jangkaan anda.
Laraskan parameter anda. Tetapkan suhu untuk kreativiti. Gunakan top_p untuk kepelbagaian. Tetapan ini mempengaruhi kualiti output. Eksperimen untuk mencari keseimbangan terbaik. Kod anda harus kekal tidak berubah kecuali untuk URL dan kunci.
