id ▾
Buka akun
mistralbaseurl.com

Dokumentasi API

Masukkan kode OpenAI-compatible Anda yang sudah ada ke endpoint kami. Panduan ini menunjukkan cara menghubungkan, mengautentikasi, dan melakukan streaming respons dengan overhead konfigurasi nol.

Autentikasi & URL Dasar

Mulailah dengan mengarahkan klien ke URL dasar yang benar. Kami menerima header OpenAI standar untuk kompatibilitas. Kunci API Anda masuk ke header Authorization sebagai token bearer. Teruskan langsung dari variabel lingkungan Anda untuk menghindari pengodean rahasia secara langsung. Pengaturan ini berfungsi dengan pustaka apa pun yang mendukung protokol OpenAI.

Permintaan Pertama

Kirim penyelesaian chat sederhana untuk memverifikasi konektivitas. Gunakan ID model "uncensored" untuk generasi teks. Titik akhir mengembalikan JSON standar dengan pilihan dan metrik penggunaan. Jika Anda mendapatkan 401, periksa format kunci Anda. 402 menunjukkan saldo prabayar tidak cukup. Pengujian cepat ini mengonfirmasi bahwa integrasi Anda siap untuk lalu lintas produksi.

curl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

Integrasi SDK Python

Konfigurasi paket OpenAI Python untuk menggunakan URL dasar kami. Setel kunci API dan nama model secara eksplisit. Teruskan pesan Anda sebagai daftar kamus dengan kunci peran dan konten. Objek respons berisi teks yang dihasilkan di choices[0].message.content. Tangani pengecualian dengan hati-hati untuk menangkap kesalahan jaringan atau batas laju selama eksekusi.

from openai import OpenAI

client = OpenAI(base_url="https://api.mistralbaseurl.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)

Pengaturan SDK Node.js

Inisialisasi klien OpenAI dengan URL dasar dan kunci Anda. Tentukan array messages dengan peran user dan assistant. Panggil chat.completions.create dengan model uncensored. Respons menyediakan teks yang dihasilkan di pilihan pertama. Gunakan pola ini untuk panggilan sinkron dan asinkron di aplikasi Node Anda.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralbaseurl.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);

Respons Streaming

Aktifkan streaming dengan mengatur stream menjadi true. API mengirim chunk data saat dihasilkan. Setiap chunk berisi teks delta yang dapat Anda tambahkan ke buffer. Pendekatan ini mengurangi latensi persepsi untuk output panjang. Pantau penggunaan token di chunk terakhir untuk melacak penagihan secara akurat.

stream = 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)

Batas & Jendela Konteks

Akun Anda mendukung jendela konteks 100.000 token. Output maksimum adalah 16.000 token per permintaan. Anda dapat mengirim 300 permintaan per menit. Hanya 8 permintaan yang berjalan secara bersamaan. Permintaan dengan ukuran isi lebih dari 8 MB akan gagal. Gunakan batas-batas ini untuk merancang logika percobaan ulang Anda. Kesalahan seperti 429 menunjukkan pelanggaran batas laju. Penolakan tidak mengonsumsi kredit.

Pertanyaan umum

Apa URL dasar mistral untuk API ini?

Gunakan HTTPS://api.mistralbaseurl.com/v1 sebagai URL dasar Anda. Ini berfungsi dengan SDK apa pun yang kompatibel dengan OpenAI. Arahkan klien Anda ke sana dan atur model menjadi uncensored.

Bagaimana cara menangani error batas laju 429?

Anda mendapatkan 429 saat melebihi 300 permintaan per menit. Terapkan backoff eksponensial di klien Anda. Coba lagi setelah periode penundaan yang ditentukan dalam header retry-after.

Apakah model tanpa sensor mendukung streaming?

Ya, atur stream menjadi true dalam permintaan Anda. API mengirim Server-Sent Events dengan delta token. Parse potongan-potongan ini untuk memperbarui UI Anda secara waktu nyata tanpa menunggu penyelesaian penuh.

Dapatkan kunci API Anda sekarang

Daftar, ambil kunci Anda, perbarui URL dasar Anda. Itu saja.