ms ▾
Buka akaun
mistralbaseurl.com

Dokumentasi API

Masukkan kod serasi OpenAI sedia ada anda ke hujung titik kami. Panduan ini menunjukkan cara menyambung, mengesahkan identiti, dan menghantar respons secara strim tanpa beban konfigurasi.

Pengesahan & URL Asas

Mula-mula, arahkan klien anda ke URL asas yang betul. Kami menerima header OpenAI piawai untuk serasi. Kunci API anda diletakkan dalam header Authorization sebagai token bearer. Hantar terus dari pembolehubah persekitaran anda untuk mengelakkan pengkodan keras rahsia. Konfigurasi ini berfungsi dengan mana-mana perpustakaan yang menyokot protokol OpenAI.

Permintaan Pertama

Hantar penyelesaian chat mudah untuk mengesahkan sambungan. Gunakan ID model "uncensored" untuk penjanaan teks. Hujung sambungan mengembalikan JSON standard dengan pilihan dan metrik penggunaan. Jika anda mendapat 401, semak format kunci anda. 402 menunjukkan baki kredit pra-dibayar tidak mencukupi. Ujian pantas ini mengesahkan integrasi anda sedia untuk trafik pengeluaran.

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

Konfigurkan pakej OpenAI Python untuk menggunakan URL asas kami. Tetapkan kunci API dan nama model secara eksplisit. Luluskan mesej anda sebagai senarai kamus dengan kunci peranan dan kandungan. Objek respons mengandungi teks yang dijana dalam choices[0].message.content. Tangani pengecualian dengan baik untuk menangkap rangkaian atau ralat had kadar semasa pelaksanaan.

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)

Persediaan SDK Node.js

Mulakan klien OpenAI dengan URL asas dan kunci anda. Takrifkan array mesej dengan peranan pengguna dan pembantu. Panggil chat.completions.create dengan model uncensored. Respons menyediakan teks yang dijana dalam pilihan pertama. Gunakan corak ini untuk panggilan sinkron dan asinkron dalam 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 penstriman dengan menetapkan stream kepada true. API menghantar chunk data apabila ia dijana. Setiap chunk mengandungi teks delta yang boleh anda tambahkan ke penimbal. Pendekatan ini mengurangkan latensi yang dirasakan untuk output panjang. Pantau penggunaan token dalam chunk terakhir untuk menjejak pengebilan dengan tepat.

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)

Had & Jendela Konteks

Akaun anda menyokong tetingkap konteks 100,000 token. Output maksimum ialah 16,000 token setiap permintaan. Anda boleh menghantar 300 permintaan setiap minit. Hanya 8 permintaan berjalan serentak. Permintaan dengan saiz badan melebihi 8MB akan gagal. Gunakan had ini untuk mereka bentuk logik cuba semula anda. Ralat seperti 429 menunjukkan pelanggaran had kadar. Penolakan tidak menggunakan kredit.

Soalan biasa

Apakah URL asas mistral untuk API ini?

Gunakan HTTPS://api.mistralbaseurl.com/v1 sebagai URL asas anda. Ia berfungsi dengan mana-mana SDK serasi OpenAI. Arahkan klien anda ke sana dan tetapkan model kepada uncensored.

Bagaimana cara mengendalikan ralat had kadar 429?

Anda mendapat 429 apabila melebihi 300 permintaan setiap minit. Laksanakan backoff eksponen dalam klien anda. Cuba lagi selepas tempoh penangguhan yang dinyatakan dalam header retry-after.

Adakah model tanpa sensor menyokong penstriman?

Ya, tetapkan stream kepada true dalam permintaan anda. API menghantar Acara Dikirim Server dengan delta token. Uraikan potongan ini untuk mengemas kini UI anda secara masa nyata tanpa menunggu penyelesaian penuh.

Dapatkan kunci API anda sekarang

Daftar, dapatkan kunci anda, kemas kini URL asas anda. Itu sahaja.