Kunci API mistral: Panduan Mula Pantas

Prasyarat: SDK dan persekitaran

Mula dengan memasang SDK serasi OpenAI pilihan anda. Anda hanya memerlukan kunci API yang sah dan URL asas untuk perkhidmatan kami.

Eksport kunci ke pembolehubah persekitaran anda supaya skrip boleh mengaksesnya dengan selamat. Cipta akaun baharu melalui Google atau e-mel untuk menerima kunci anda serta-merta. Tiada pengesahan nombor telefon diperlukan untuk langkah ini.

Pastu persekitaran anda menyokong perpustakaan HTTP standard. API ini mengharapkan payload JSON standard untuk semua permintaan. Anda tidak perlu memasang pemacu khusus vendor.

Menetapkan URL asas

Arahkan klien SDK anda ke hujung khusus kami untuk inferens tanpa sensor. URL asas menggantikan hujung OpenAI standard dalam konfigurasi anda.

Gunakan HTTPS://api.apikeymistral.com/v1 sebagai URL asas anda. Ini memastikan semua permintaan disalurkan melalui pelayan berkapasiti tinggi kami. Anda tidak perlu mengubah laluan endpoint jika SDK anda secara lalai menggunakan /chat/completions.

Simpan kunci API anda dalam memori atau peti simpan selamat. Kunci ini mengesahkan setiap permintaan yang anda hantar ke URL ini.

Membuat permintaan POST pertama anda

Hantar permintaan penyelesaian chat standard untuk mendapatkan output teks. Gunakan ID model "uncensored" untuk mengakses model yang telah disesuaikan kami.

Nyatakan suhu dan parameter lain untuk mengawal kreativiti. Endpoint menerima badan JSON standard dengan array mesej.

Berikut adalah arahan curl asas untuk menguji sambungan:

Copycurl https://api.apikeymistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json object with keys name age"}]
  }'

Sahkan respons mengandungi teks yang dijana. Semak kod status adalah 200 untuk kejayaan.

Python SDK integration

Konfigurkan klien Python untuk menggunakan URL asas kami. Mulakan klien dengan kunci API anda dan hujung tersuai.

Panggil kaedah chat.completions.create dengan prompt anda. Objek respons mengandungi teks yang dijana dalam choices[0].message.content.

Tangani ralat berpotensi seperti had kadar atau kunci tidak sah dengan baik. Log penggunaan token jika diperlukan untuk penjejakan kos.

Copyfrom openai import OpenAI

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

Pendekatan ini berfungsi dengan mana-mana perpustakaan serasi OpenAI. Anda boleh guna semula kod sedia ada dengan perubahan minimum.

Integrasi SDK Node

Mulakan klien Node.js dengan URL asas tersuai. Lulus kunci API anda dalam objek konfigurasi.

Panggil fungsi chat.completions.create dengan parameter yang dikehendaki. Respons mengikut format OpenAI piawai.

Proses aliran atau respons akhir mengikut keperluan. Penanganan ralat harus menangkap isu rangkaian atau kegagalan pengesahan.

Copyimport OpenAI from "openai";

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

Persediaan ini membolehkan anda mengintegrasikan penyimpulan tanpa sensor ke dalam aplikasi Node anda dengan cepat.

Mengendalikan respons aliran

Aktifkan penstriman dengan menetapkan stream=true dalam permintaan anda. API mengembalikan data dalam chunk apabila ia dijana.

Proses setiap potongan untuk memaparkan output masa nyata kepada pengguna anda. Kumpulkan kandungan untuk mendapatkan respons penuh.

Pantau penggunaan token dalam potongan akhir aliran. Ini membantu anda menjejaki kos dengan tepat.

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)

Penstriman mengurangkan latensi yang dirasakan untuk respons panjang. Ia sesuai untuk antara muka sembang dan aplikasi interaktif.

Had, ralat, dan tetingkap konteks

Memahami had teknikal untuk mengelakkan gangguan perkhidmatan. Tetingkap konteks menyokong 100,000 token untuk prompt dan penyelesaian digabungkan.

Output maks ialah 16,000 token setiap permintaan. Tetapkan max_tokens secara eksplisit untuk mengelakkan mencapai lalai 2,048.

Rate limits allow 300 requests per minute per key. You can have 8 concurrent requests at a time.

Tangani ralat 401 dengan memeriksa kesahihan kunci anda. Ralat 402 menunjukkan kredit tidak mencukupi. Ralat 429 bermaksud anda mencapai had kadar.

Permintaan melebihi had saiz badan 8 MB akan gagal. Rancang payload anda dengan sewajarnya.