Panduan Cepat untuk Pengguna Mistral

URL Dasar & Autentikasi

API kami sepenuhnya kompatibel dengan SDK OpenAI. Anda hanya perlu memperbarui URL dasar dan menyediakan kunci API Anda. URL dasar untuk layanan ini adalah https://api.mistralapi.com/v1. Autentikasi ditangani melalui header Authorization menggunakan token Bearer. Tidak seperti beberapa penyedia, kami tidak memerlukan routing kompleks atau header khusus vendor; cukup kirimkan kunci Anda seperti biasa.

• URL Dasar: https://api.mistralapi.com/v1
• Header: Authorization: Bearer YOUR_API_KEY

Kunci API Anda dibuat segera setelah pendaftaran. Jaga agar tetap aman karena kunci ini memberikan akses ke saldo prabayar Anda. Tidak ada biaya langganan bulanan, hanya harga berdasarkan penggunaan token.

Endpoint Chat Completions

Inti API kami adalah endpoint POST /v1/chat/completions. Endpoint ini menerima daftar pesan dan mengembalikan respons yang dihasilkan. Endpoint ini mendukung format pesan standar yang digunakan oleh sebagian besar klien LLM. Anda harus menentukan ID model sebagai "uncensored". Model ini adalah model bahasa besar bobot terbuka yang dihosting di server kami, disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah.

• Endpoint: POST /v1/chat/completions
• ID Model: uncensored

API hanya mengembalikan respons teks. Tidak mendukung gambar, audio, video, atau embedding. Untuk sebagian besar pengembang, endpoint ini menggantikan endpoint chat OpenAI standar tanpa perubahan kode selain URL dasar dan ID model.

Integrasi SDK Python

Menggunakan pustaka Python OpenAI resmi adalah cara tercepat untuk melakukan integrasi. Atur URL dasar ke endpoint kami dan berikan kunci API Anda. Kode di bawah ini menunjukkan permintaan penyelesaian teks sederhana.

• Instal pustaka: pip install openai
• Atur base_url ke https://api.mistralapi.com/v1
• Gunakan model="uncensored"

Pendekatan ini berfungsi karena API kami mencerminkan struktur respons OpenAI. Anda dapat menggunakan pustaka yang ada untuk streaming, pemanggilan fungsi, dan mode JSON tanpa modifikasi.

Integrasi SDK Node.js

Untuk pengembang JavaScript/TypeScript, paket npm openai berfungsi dengan lancar. Konfigurasikan klien dengan URL dasar kami dan kunci API Anda. Ini memungkinkan Anda menggunakan basis kode yang sama untuk OpenAI dan model tanpa sensor kami.

• Instal pustaka: npm install openai
• Konfigurasikan baseUrl ke https://api.mistralapi.com/v1
• Tentukan model: "uncensored"

Kompatibilitas ini berlaku untuk semua parameter standar seperti temperature, top_p, dan urutan stop. Anda dapat beralih antar penyedia dengan mudah dengan mengubah konfigurasi klien.

Respons Streaming

Kami mendukung respons streaming melalui Server-Sent Events (SSE). Ini memungkinkan Anda menerima token saat dihasilkan, mengurangi latensi yang dirasakan oleh pengguna. Bagian akhir stream mencakup statistik penggunaan token untuk penagihan.

• Atur stream: true dalam permintaan Anda
• Baca bagian dari respons
• Parse bagian akhir untuk data penggunaan

Streaming sangat ideal untuk antarmuka obrolan dan aplikasi waktu nyata. Format respons sesuai dengan standar streaming OpenAI, sehingga logika streaming yang ada akan berfungsi tanpa perubahan.

Batas, Kesalahan & Jendela Konteks

API kami memiliki batas tertentu untuk memastikan stabilitas. Setiap kunci API mendukung 300 permintaan per menit dan 8 permintaan paralel. Ukuran tubuh permintaan maksimum adalah 8 MB. Jendela konteks adalah 100.000 token total (prompt + completion). Jika Anda tidak mengatur max_tokens, output default adalah 2.048 token; jika tidak, output maksimum adalah 32.000 token.

• 401: Kunci API tidak valid
• 402: Kredit tidak mencukupi
• 429: Batas laju terlampaui

Saldo premium tidak pernah kedaluwarsa. Kesalahan dan penolakan gratis. Jika Anda mengalami masalah, gunakan halaman Dukungan untuk pengembalian dana atau bantuan akun.

cURL

Salincurl https://api.mistralapi.com/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."}]
  }'

Python

Salinfrom openai import OpenAI

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

Node.js

Salinimport OpenAI from "openai";

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

Streaming

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