توثيق API للمطورين

إعداد عنوان URL الأساسي والمصادقة

استخدم HTTPS://api.mistralkey.com/v1 كعنوان URL الأساسي. مرر مفتاح API الخاص بك في Authorization رأس. أنشئ مفتاحك عبر Google أو البريد الإلكتروني في لوحة التحكم. لا يلزم رقم هاتف. لا تنتهي صلاحية الرصيد.

Copycurl https://api.mistralkey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the main configuration options for the server"}]
  }'

الطلب الأول

أرسل طلب POST إلى نقطة نهاية إكمال الدردشة. حدد النموذج كـ "uncensored". يعالج النظام مدخلاتك ويعيد نصًا مُولّدًا. الأخطاء والرفض لا تستهلك الرصيد. هذا يضمن شفافية حساب الرموز.

Copyfrom openai import OpenAI

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

قم بتهيئة العميل باستخدام عنوان URL الأساسي والمفتاح الخاص بك. قم بتكوين النموذج لاستخدام النسخة غير المقيدة. تتعامل الحزمة مع التسلسل تلقائيًا. يلغي هذا النهج التخمين من طبقة التكامل الخاصة بك.

Copyimport OpenAI from "openai";

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

استجابات البث

فعّل التدفق عن طريق تعيين stream parameter إلى true. استلم الرموز عبر أحداث الإرسال من الخادم. تظهر تفاصيل استخدام الرموز في الجزء الأخير. يقلل هذا من زمن الاستجابة المُدرَك للمخرجات الطويلة.

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)

حدود المعدلات والقيود

الحد هو 300 طلب في الدقيقة لكل مفتاح. الطلبات المتزامنة محدودة بـ 8. حجم جسم الطلب لا يمكن أن يتجاوز 8 ميجابايت. يمتد نافذة السياق إلى 100,000 رمز. الحد الأقصى للمخرجات لكل طلب هو 16,000 رمز.

معالجة الأخطاء والتوكن

التعامل مع أخطاء 401 للمفاتيح غير الصالحة. إرجاع 402 عندما يستنفد الرصيد. إدارة 429 عند تجاوز حد معدل الطلب. الأخطاء مجانية. يعكس استخدام الرصيد استهلاك الرموز الفعلية فقط.