Alihkan klien Anda dalam tiga baris

URL Dasar & Autentikasi

Untuk menggunakan API, arahkan klien Anda ke https://api.mistralapi.top/v1. Autentikasi bergantung pada token bearer yang disertakan dalam header Authorization. Anda menghasilkan kunci ini melalui halaman Dapatkan kunci API menggunakan akun Google atau pengaturan email/kata sandi standar. Kunci ditampilkan segera setelah dibuat. Simpan token ini dengan aman karena memberikan akses penuh ke saldo prabayar Anda. Tidak seperti penyedia standar, kami tidak memerlukan nomor telepon atau kartu kredit untuk aktivasi kredit uji coba awal.

Layanan kami dirancang agar dapat langsung dimasukkan ke dalam konfigurasi klien Mistral atau OpenAI yang ada. Cukup perbarui properti base_url pada instance SDK Anda. Struktur endpoint sesuai dengan format standar /v1/chat/completions, sehingga kode Anda yang ada berfungsi tanpa modifikasi. Kami mendukung satu ID model, uncensored, yang menangani semua tugas generasi teks.

Endpoint Chat Completions

Interaksi inti terjadi melalui endpoint POST /v1/chat/completions. Anda mengirimkan body JSON yang berisi ID model, array messages, dan parameter opsional. API mengembalikan respons teks atau data terstruktur jika Anda menentukan mode JSON. Endpoint ini adalah cara utama untuk berinteraksi dengan LLM. Endpoint ini mendukung permintaan sinkron standar dan respons streaming. Setiap permintaan mengonsumsi token dari saldo prabayar Anda berdasarkan volume input dan output.

Kesalahan ditangani melalui kode status HTTP standar. Jika kunci Anda tidak valid, Anda menerima 401. Jika saldo kredit Anda habis, Anda menerima 402. Batas laju diterapkan pada 300 permintaan per menit dan 8 koneksi paralel per kunci. Gunakan contoh berikut untuk memverifikasi koneksi dan validitas kunci Anda.

Copycurl https://api.mistralapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Respons Streaming (SSE)

Untuk latensi lebih rendah dan pengalaman pengguna yang lebih baik, aktifkan streaming dengan mengatur stream: true dalam tubuh permintaan Anda. API mengembalikan aliran Server-Sent Events (SSE). Setiap bagian berisi respons parsial. Bagian terakhir mencakup statistik penggunaan token lengkap untuk permintaan tersebut. Ini memungkinkan aplikasi Anda menampilkan token saat token tersebut dihasilkan, daripada menunggu penyelesaian penuh. Streaming sangat ideal untuk antarmuka obrolan di mana umpan balik segera sangat penting.

Saat menggunakan streaming, pastikan klien Anda memformat format SSE dengan benar. Array choices dalam setiap potongan akan berisi konten delta. Anda harus mengumpulkan delta-delta ini untuk membangun respons lengkap. Penggunaan token hanya tersedia dalam peristiwa terakhir dari stream. Gunakan metode ini untuk menjaga pengguna Anda tetap terlibat saat model memproses prompt yang kompleks.

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)

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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