Dokumentasi API Mistral: Panduan Mulai Cepat

Instal SDK dan atur base URL Anda

Mulai dengan menginstal SDK resmi untuk bahasa Anda dan arahkan ke endpoint kami. Base URL-nya adalah HTTPS://api.mistralapidoc.com/v1. Perubahan tunggal ini mengarahkan semua panggilan ke infrastruktur uncensored kami tanpa mengubah logika yang sudah ada. Anda dapat menggunakan klien standar apa pun yang mendukung kompatibilitas OpenAI. Penyiapan memakan waktu beberapa detik dan tidak memerlukan file konfigurasi yang rumit.

Pastikan Anda meneruskan kunci API unik Anda di header Authorization. Sistem kami memvalidasi kunci ini terhadap saldo pra-bayar Anda sebelum memproses token apa pun. Pendekatan ini memastikan Anda hanya membayar untuk apa yang Anda gunakan. Jaga kunci Anda tetap aman dan putar jika Anda mencurigai adanya paparan. Kunci dikeluarkan segera setelah pendaftaran melalui Google atau email.

Lakukan permintaan pertama Anda ke model uncensored

Kirim permintaan POST ke /v1/chat/completions dengan ID model diatur ke "uncensored". Model ini merespons konten dewasa yang sah, fiksi, dan topik kontroversial tanpa penolakan standar. Ini adalah model open-weight yang di-tune untuk jawaban langsung. Anda tidak perlu menentukan nomor versi atau memilih rute antar vendor yang berbeda. Respons mengembalikan teks dalam bidang content.

Copycurl https://api.mistralapidoc.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models and their context windows"}]
  }'

Badan permintaan mencakup array pesan Anda dan parameter opsional. API kami mengabaikan bidang tambahan dengan baik. Jika Anda mengirimkan prompt sederhana, Anda akan mendapatkan kelengkapan langsung. Gunakan ini untuk memverifikasi bahwa integrasi Anda berfungsi sebelum menambahkan logika kompleks. Model menangani konteks hingga 100,000 token secara efisien.

Aktifkan streaming dan tangani penggunaan token

Atur stream ke true untuk menerima token melalui Server-Sent Events. Metode ini mengurangi latensi yang dirasakan untuk respons panjang. Chunk terakhir dalam stream berisi statistik penggunaan token lengkap untuk permintaan tersebut. Anda dapat mencatat metrik ini untuk melacak konsumsi kredit prabayar Anda secara akurat. Streaming sangat ideal untuk antarmuka obrolan dan aplikasi real-time.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Tangani respons parsial dengan mengakumulasi delta konten. API kami memastikan jumlah total token sesuai dengan penggunaan aktual. Kesalahan selama streaming tidak membebankan Anda untuk token yang tidak lengkap. Fitur ini memberikan pengalaman pengguna yang mulus sambil menjaga transparansi biaya. Anda dapat menghentikan aliran awal jika pengguna mengganggu generasi.

Gunakan pemanggilan fungsi dan mode JSON

Lewatkan array tools untuk mengaktifkan panggilan fungsi. Model akan mengeluarkan panggilan alat terstruktur ketika sesuai. Anda juga dapat memaksakan mode JSON dengan mengatur response_format menjadi json_object. Ini menjamin output adalah JSON yang valid, yang menyederhanakan parsing di aplikasi Anda. Kedua fitur ini bekerja dengan sintaks SDK OpenAI standar.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralapidoc.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Tentukan skema fungsi Anda dengan nama, deskripsi, dan parameter. API mengembalikan nama fungsi dan argumen dalam respons. Ini memungkinkan kode Anda mengeksekusi logika eksternal berdasarkan keputusan model. Mode JSON berguna ketika Anda membutuhkan struktur data yang ketat. Gabungkan fitur-fitur ini untuk alur kerja otomatis yang kuat.

Konfigurasi parameter: suhu, top_p, dan seed

Sesuaikan temperatur untuk mengontrol keacakan. Nilai yang lebih rendah membuat respons lebih deterministik. Top_p membatasi sampling inti hanya pada token yang paling mungkin. Seed memastikan output yang dapat direproduksi untuk debugging. Parameter-parameter ini memberikan kontrol yang lebih halus atas perilaku model. Gunakan parameter ini untuk menyesuaikan keseimbangan antara kreativitas dan akurasi.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralapidoc.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Atur presence_penalty dan frequency_penalty untuk mengurangi pengulangan. Model mendukung semua parameter standar OpenAI. Anda dapat meneruskan urutan stop untuk menghentikan generasi pada penanda tertentu. Kontrol ini membantu Anda mendapatkan format output yang tepat. Eksperimen dengan kombinasi berbeda untuk menemukan pengaturan optimal untuk kasus penggunaan Anda.

Batas, error, dan jendela konteks

API kami mendukung jendela konteks 100.000 token. Output maksimum per permintaan adalah 16.000 token, atau 2.048 jika Anda tidak menetapkan max_tokens. Anda dibatasi hingga 300 permintaan per menit dan 8 permintaan simultan per kunci. Tubuh permintaan harus tetap di bawah 8 MB. Batas-batas ini memastikan penggunaan yang adil bagi semua pelanggan pra-bayar.

Tangani kesalahan HTTP 401 dengan memverifikasi kunci API Anda. Kesalahan 402 menunjukkan kredit prabayar tidak cukup. Isi ulang dengan kripto untuk melanjutkan layanan. Kesalahan 429 berarti Anda telah melebihi batas laju. Tunggu sebentar sebelum mencoba lagi. Sistem kami tidak menggunakan prompt untuk pelatihan, melestarikan privasi data Anda. Kesalahan dan penolakan itu gratis, jadi Anda hanya membayar untuk penyelesaian yang berhasil.