Panduan Awal API

Autentikasi & URL Dasar

API menggunakan autentikasi kompatibel OpenAI standar. Anda menerima kunci API segera setelah mendaftar dengan Google atau email. Gunakan kunci ini di Authorization header untuk semua permintaan. URL dasar tetap di https://api.mistralabliterated.com/v1. Tidak diperlukan konfigurasi tambahan untuk jalur endpoint.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

Kunci Anda mengidentifikasi akun Anda dan melacak penggunaan. Jika Anda kehilangan kunci Anda, buat kunci baru; kunci lama menjadi tidak valid.

POST /v1/chat/completions

Kirim pesan ke model menggunakan endpoint penyelesaian obrolan standar. ID modelnya selalu uncensored. Endpoint ini menangani interaksi teks masuk dan teks keluar tanpa memerlukan struktur payload yang kompleks. Anda dapat mengirim pesan system, user, dan assistant dalam satu permintaan.

Copyfrom openai import OpenAI

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

Permintaan mengembalikan respons JSON terstruktur yang berisi output model. Anda dapat menyesuaikan parameter seperti temperature dan top_p untuk mengendalikan kreativitas. Model tidak menolak topik dewasa atau kontroversial yang sah, memberikan gaya respons mentah. Kesalahan mengembalikan kode status HTTP standar untuk debugging yang mudah di basis kode Anda.

GET /v1/models

Kirim permintaan ke model yang tersedia untuk memverifikasi konektivitas dan konfigurasi. Endpoint ini mengembalikan daftar model yang tersedia, mengonfirmasi bahwa autentikasi dan URL dasar Anda benar. Ini berguna untuk menguji integrasi Anda sebelum mengirim payload berat.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralabliterated.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 mencakup ID model dan tipe objek. Anda dapat menggunakan titik akhir ini dalam urutan startup aplikasi Anda untuk memastikan API dapat dijangkau. Respons dikembalikan segera dengan latensi rendah, menjadikannya ideal untuk pemeriksaan kesehatan. Tidak ada kredit yang dikonsumsi oleh permintaan ini.

Streaming & Tools

Aktifkan streaming dengan mengatur stream: true dalam permintaan Anda. API mengirim chunk teks melalui Server-Sent Events (SSE) saat chunk tersebut dihasilkan. Ini mengurangi latensi yang dirasakan bagi pengguna yang menunggu respons panjang. Anda juga dapat menggunakan pemanggilan fungsi dengan menyediakan daftar alat dalam permintaan.

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)

Statistik penggunaan token disertakan dalam potongan terakhir stream. Ini memungkinkan Anda melacak biaya secara real-time. Model mendukung mode JSON untuk output terstruktur ketika Anda mengatur response_format ke {"type": "json_object"}Pilihan alat bersifat fleksibel, memungkinkan pemilihan spesifik atau otomatis.

Parameter & Batas

Jendela konteks mendukung 100.000 token untuk prompt dan completion gabungan. Output maksimum per permintaan adalah 16.000 token, atau 2.048 jika Anda tidak menentukan max_tokens. Anda dapat mengontrol generasi dengan temperature, top_p, stop, dan seed parameter. Penalti frekuensi dan kehadiran juga tersedia untuk penyesuaian.

Batas laju mengizinkan 300 permintaan per menit per kunci dan 8 permintaan konkurensi. Ukuran badan permintaan maksimum adalah 8 MB. Batas-batas ini memastikan kinerja stabil untuk aplikasi throughput tinggi. Sesuaikan strategi pengelompokan Anda agar tetap dalam batas ini.

Error & Harga

HTTP 401 menunjukkan kunci API tidak valid atau hilang. HTTP 402 berarti kredit prabayar Anda telah habis; isi ulang dengan kripto untuk melanjutkan. HTTP 429 menandakan batas laju telah tercapai; tunggu atau kurangi konkurensi. Error tidak mengonsumsi kredit, sehingga Anda tidak dibebankan biaya untuk permintaan yang gagal.

Harga adalah $0,15 per juta token input dan $0,50 per juta token output. Kredit tidak pernah kedaluwarsa, dan tidak ada biaya bulanan. Pengisian ulang mulai dari $20 dengan bonus untuk jumlah yang lebih besar. Pengembalian dana tidak tersedia, tetapi dukungan dapat memperbaiki pengisian ganda.