دليل البداية السريعة
ابدأ في توليد النصوص باستخدام نموذج LLM غير الخاضع للرقابة باستخدام كود متوافق مع OpenAI. تحتاج فقط إلى عنوان URL أساسي ومفتاح API واحد لتكامل هذا النموذج في خطوط أنابيب الأتمتة الخاصة بك.
عنوان URL الأساسي والمصادقة
تعيش واجهة برمجة التطبيقات عند https://api.mistralapipricing.com/v1. مرر مفتاحك في Authorization الرأس. ينطبق منطق تسعير Mistral API لكل رمز، لذا حافظ على نظافة الرؤوس. تحقق من الاتصال باستخدام GET /v1/models.
- رأس:
Authorization: Bearer YOUR_KEY - URL الأساسي:
https://api.mistralapipricing.com/v1
curl https://api.mistralapipricing.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the cost per token for each model."}]
}'
إرسال طلبك الأول
استدع chat/completions النقطة النهائية مع معرف النموذج الخاص بك. يستجيب النموذج غير المقيد للمطالبات القياسية دون رفض. تكلفة الرموز المدخلة 0.15 دولار لكل مليون. تكلفة الرموز المخرجة 0.50 دولار لكل مليون. لا تستهلك الأخطاء رصيدك.
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapipricing.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
استخدم الحزمة الرسمية أو axios لإرسال الطلبات. حدد عنوان URL الأساسي بشكل صحيح. معرف النموذج هو دائماً uncensored. يجب أن تتضمن الرؤوس رمز bearer الخاص بك. تعود الاستجابات بكائنات JSON. تعامل مع الأخطاء بسلاسة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralapipricing.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: true. استلم الرموز عبر أحداث الإرسال عبر الخادم. يحتوي الجزء الأخير على بيانات الاستخدام. يقلل هذا من زمن الاستجابة المدرك للمخرجات الطويلة. قم بتخزين الرموز على جانب العميل. اعرضها عند وصولها.
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)
استدعاء الوظائف ووضع JSON
عرّف الأدوات في جسم الطلب. يعيد النموذج JSON صالحًا. استخدم response_format: {"type": "json_object"} للمخرجات الصارمة. قم بتحليل النتيجة في منطق التطبيق الخاص بك. يعمل هذا لمهام الأتمتة. تحقق من صحة المخطط في جانبك.
حدود، أخطاء، والسياق
نافذة السياق هي 100,000 رمز إجمالاً. يتم تقييد الطلبات بـ 300 في الدقيقة. تحصل على 8 طلبات متزامنة. يعني خطأ 401 مفتاحاً غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد. يشير خطأ 429 إلى تجاوز حد المعدل. الحد الأقصى للإخراج هو 16,000 رمز.
الأسئلة الشائعة
كيف أحدد الحد الأقصى للمبلغ الذي قد تكلفني إياه الواجهة البرمجية؟
لا تدعم الـ API تحديد حدود إنفاق صارمة مباشرةً. راقب الاستخدام عبر رؤوس الاستجابة أو تتبع الرموز في منطق تطبيقك. الرصيد المدفوع مسبقاً لا ينتهي صلاحيته، لذا تتحكم في الحد الأقصى بمبلغ الإيداع الخاص بك.
ماذا يحدث إذا تجاوزت حد معدل الطلب؟
تتلقى رمز الحالة 429. لا يستهلك الطلب أي رموز. انتظر بضع ثوانٍ وأعد المحاولة. أنت مقيد بـ 300 طلب في الدقيقة لكل مفتاح. اضبط التزامن للبقاء تحت 8 طلبات متزامنة.
هل النموذج غير المقيد هو نفسه نماذج Mistral AI؟
لا. نستضيف نموذجًا مفتوح الوزن مضبوطًا لعدم الرفض. إنه ليس GPT أو Claude أو نماذج Mistral الرسمية. إنه متوافق مع نفس بنية واجهة برمجة التطبيقات ولكن له معرف نموذج خاص به. راجع صفحة الأسعار للحصول على التفاصيل.
احصل على مفتاحك في ثوانٍ
سجّل الدخول، وانسخ المفتاح الخاص بك، وحدّث عنوان URL الأساسي. هذا كل التكوين المطلوب.