بداية سريعة لنقطة النهاية المتوافقة مع OpenAI

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

توصيل إلى API الخاص بنا باستخدام عنوان URL الأساسي الموحّد ومفتاحك الفريد. يتطلب كل طلب مصادقة عبر رأس Authorization لضمان الوصول الآمن إلى رصيدك المدفوع مسبقًا.

يعكس هيكل نقطة النهاية المعيار الصناعي، مما يسمح لك بتبديل تكوين OpenAI الحالي مع احتكاك قليل. لا تحتاج إلى إدارة التوجيه المعقد أو حبس المورد؛ نحن نتعامل مع البنية التحتية بينما تركز على منطق التطبيق.

أنشئ مفتاحك فوراً عبر لوحة التحكم. تحتفظ كل حساب بمفتاح نشط واحد يحل محل المفتاح السابق عند تجديده، مما يبقي وضع الأمان الخاص بك بسيطاً وشفافاً.

Copycurl https://api.aiinferenceapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

نقطة نهاية إكمال الدردشة

أرسل تلميحك إلى نقطة إكمال الدردشة للحصول على استجابة نصية مباشرة من النموذج غير الخاضع للرقابة. تتعامل نقطة النهاية هذه مع جميع توليد النصوص دون عبء التضميمات أو المعالجة متعددة الوسائط.

النموذج يقبل مصفوفة رسائل قياسية تحتوي على أدوار النظام والمستخدم والمساعد. إنه مُضبط للإجابة دون رفض المحتوى للاستخدام البالغ القانوني، مما يجعله مثاليًا للكتابة الإبداعية، أو لعب الأدوار، أو تحليل البيانات غير المقيد.

حافظ على حمولاتك (payloads) موجزة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت، وهو يتسع بسهولة لمعظم سجلات المحادثات القياسية قبل الوصول إلى حد السياق.

Copyfrom openai import OpenAI

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

استخدام الرموز والبث

تمكين المخرجات في الوقت الفعلي عن طريق ضبط معلمة stream على true في طلبك. تُعيد الواجهة البرمجية تدفق أحداث الخادم المرسلة (SSE)، مما يسمح لك بعرض الرموز بمجرد توليدها.

تتضمن إحصائيات استهلاك الرمز الشريحة الأخيرة من التدفق. يحافظ هذا التصميم على حجم الحمولة خفيفاً أثناء التوليد مع ضمان حصولك على بيانات فوترة دقيقة لرصيدك المدفوع مسبقاً.

يقلل التدفق من زمن الاستجابة المُدرَك للمستخدمين النهائيين. يمكنك بدء عرض الاستجابة فوراً، وهو أمر حاسم للتطبيقات التي تتطلب حلقات تغذية راجعة تفاعلية أو توليد محتوى طويل.

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)

استدعاء الوظائف ووضع JSON

هيكل مخرجاتك للاستهلاك البرمجي باستخدام وضع JSON أو استدعاء الوظائف. اضبط response_format على json_object لفرض مخطط JSON صارم على النموذج.

بالنسبة لاستخدام الأدوات، عرّف دوالك في مصفوفة tools. سيعيد النموذج حججاً منظمة يمكن لبرمجتك تحليلها وتنفيذها. تدعم هذه القدرة سير العمل المعقدة دون الحاجة إلى مكتبات تحليل خارجية.

وضع JSON مفيد بشكل خاص عند استخراج البيانات من النص غير المهيكل. يضمن تنسيقًا متسقًا، مما يقلل من الحاجة إلى تنظيف المعالجة اللاحقة في منطق التطبيق الخاص بك.

Copyimport OpenAI from "openai";

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

المعاملات: درجة الحرارة، Top P، و Stop

تحكم في إبداع وإنهاء استجاباتك باستخدام معاملات التوليد القياسية. اضبط درجة الحرارة للتباير وtop_p لأخذ العينات النووية. استخدم معلمة stop لتحديد تسلسلات محددة تشير إلى نهاية المخرجات.

إنتاج درجة حرارة أقل نتائج أكثر حتمية وتركيزًا. تقدم القيم الأعلى المزيد من العشوائية، وهو ما يمكن أن يكون مفيدًا للعصف الذهني أو مهام سرد القصص الإبداعية.

عرّف تسلسلات التوقف لمنع النموذج من التشغيل إلى ما لا نهاية. هذا ضروري للحفاظ على استخدام متوقع للرموز وضمان تلقي تطبيقك استجابة نظيفة ومنفصلة.

معالجة الأخطاء والحدود

راقب طلباتك بحثًا عن رموز حالة HTTP الشائعة لإدارة الأخطاء بفعالية. يشير 401 إلى مفتاح API غير صالح أو منتهي الصلاحية، بينما يشير 402 إلى استنفاد رصيدك المدفوع مسبقًا.

يتم تفعيل حد معدل 429 إذا تجاوزت 300 طلب في الدقيقة أو كان لديك أكثر من 30 طلباً متزامناً لكل مفتاح. زد معدل نقلك عن طريق توزيع الحمل عبر مفاتيح متعددة أو تقليل تردد الطلب.

نوافذ السياق الخاصة بك تدعم 100,000 رمز توكن لكل من المدخلات والمخرجات مجتمعة. كن حذرًا من هذا الحد لتجنب الاقتطاع. الأخطاء والرفضات لا تستهلك رموز توكن، لذا تدفع فقط مقابل التوليد الفعلي.