تكامل الـ غير خاضع للرقابة النموذج في 5 دقائق

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

ابدأ بتوجيه عميلك إلى https://api.keyapimistralai.com/v1. مرر مفتاحك في Authorization قيمة التوكن كـ bearer token. يعمل مع مكتلات SDK الرسمية الخاصة بـ OpenAI وأي عميل متوافق عن طريق تغيير base_url ومفتاح API. لا يلزم تكوين إضافي للمصادقة.

أرسل أول إكمال محادثة لك

أجرِ طلب POST إلى /v1/chat/completions باستخدام معرف النموذج "uncensored". تقبل نقطة النهاية النص وتُرجِج النص. يمكنك ضبط معلمات مثل temperature و top_p للتحكم في الإبداع. الأخطاء والرفضات مجانية، لذا تدفع فقط مقابل استخدام الرموز الفعلي. إليك مثال أساسي باستخدام curl:

Copycurl https://api.keyapimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top three installation steps for Linux"}]
  }'

يشمل الرد عدد الرموز لشفافية الفوترة.

تكامل واجهة برمجة تطبيقات Python

ثبّت الحزمة الرسمية من OpenAI وقم بتكوين العميل لاستخدام عنوان URL الأساسي الخاص بنا. اضبط النموذج على uncensored لإجابات غير مقيدة للمحتوى. يتيح لك هذا الأسلوب إعادة استخدام التعليمات البرمجية الحالية من مقدمي الخدمات الآخرين. تتعامل أداة SDK مع تسلسل JSON ومنطق إعادة المحاولة تلقائيًا. قم بتكوين مفتاحك عبر متغيرات البيئة أو مباشرة في تهيئة العميل.

Copyfrom openai import OpenAI

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

يضمن هذا الإعداد تكامل تطبيقات Python الخاصة بك بسلاسة مع واجهة برمجة التطبيقات الخاصة بنا.

إعداد SDK Node.js

استخدم ال openai npm package to connect to our service. Initialize the client with the correct base URL and your API key. Send messages using the chat completions endpoint. Node.js developers can leverage existing libraries built for OpenAI compatibility. The response structure matches standard OpenAI formats for easy parsing.

Copyimport OpenAI from "openai";

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

تذكر معالجة العمليات غير المتزامنة (async) بشكل صحيح عند معالجة الاستجابة.

تمكين التدفق مع أحداث الخادم المرسلة (SSE)

تعيين stream: 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)

هذه الطريقة مثالية لواجهات الدردشة حيث تكون التغذية الراجعة في الوقت الفعلي حاسمة.

حدود، أخطاء، ونافذة السياق

تدعم واجهة برمجة التطبيقات الخاصة بنا نافذة سياق بحجم 100,000 رمز للمهام المعقدة. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. أنت محدود بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يعني خطأ 401 أن مفتاحك غير صالح. يشير خطأ 402 إلى عدم كفاية رصيد الدفع المسبق. يشير خطأ 429 إلى أنك وصلت إلى حد معدل الطلب. الأخطاء مجانية، لذا لا تدفع مقابل الطلبات الفاشلة. أدر مفاتيحك بعناية لأن مفتاحًا نشطًا واحدًا يستبدل القديم.