المصادقة ومفاتيح API
ابدأ بإنشاء حساب للحصول على مفتاح واجهة برمجة التطبيقات (API key) على الفور. يمكنك التسجيل باستخدام Google أو البريد الإلكتروني وكلمة المرور دون الحاجة إلى رقم هاتف. يولّد النظام مفتاحًا نشطًا واحدًا لكل حساب، واستبدال المفتاح القديم بآخر جديد يتم فورًا. لا تحتاج سوى إلى عنوان بريد إلكتروني للبدء، ولا تُستخدم نصوصك في تدريب النموذج. استخدم هذا المفتاح في Authorization قيمة التوكن كـ bearer token لجميع الطلبات.
الطلب الأول
أرسل استدعاءك الأول إلى نقطة نهاية إكمال المحادثة باستخدام مفتاح API الخاص بك. عنوان URL الأساسي هو https://api.aidphn.com/v1 ويعمل مع عملاء OpenAI القياسيين المتوافقين. يجب عليك تحديد النموذج uncensored للوصول إلى نموذج اللغة الكبير غير المفلتر. لا تستهلك الأخطاء والرفض رصيدك المدفوع مسبقاً، لذا يمكنك الاختبار بأمان.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'تحقق من أن المفتاح يعمل عن طريق التحقق من قائمة النماذج. يؤكد هذا الاتصال قبل إرسال طلبات معقدة. تقبل واجهة برمجة التطبيقات النص كمدخلات وتعيد النص كمخرجات، وتدعم المعلمات القياسية مثل درجة الحرارة و top_p.
تكامل واجهة برمجة تطبيقات Python
استخدم مكتبة بايثون الرسمية من OpenAI للتفاعل مع نقطة النهاية الخاصة بنا. قم بتعيين عنوان URL الأساسي إلى خادم واجهة برمجة التطبيقات الخاصة بنا وقدم مفتاحك. يتيح لك هذا النهج إعادة استخدام الكود الموجود من مشاريع OpenAI دون تغييرات كبيرة. يظل معرف النموذج uncensored لجميع الإكمالات.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)يمكنك تكوين معلمات مثل max_tokens للتحكم في طول المخرجات. الحد الأقصى الافتراضي للمخرجات هو 2,048 رمزاً، ولكن يمكنك زيادته إلى 16,000 لكل طلب. التدفق متاح للاستجابات الطويلة لتقليل زمن الاستجابة.
استخدام Node SDK
قم بدمج واجهة برمجة التطبيقات في تطبيقات Node.js الخاصة بك باستخدام حزمة SDK القياسية. وجّه العميل إلى عنوان URL الأساسي الخاص بنا وقم بالمصادقة باستخدام مفتاحك. تدعم هذه الطريقة كل من الطلبات المتزامنة وغير المتزامنة لتكامل مرن. يمكنك تمرير الأدوات لاستدعاء الوظائف أو فرض أوضاع إخراج JSON.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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);تعامل مع الاستجابات من خلال تحليل حقل المحتوى من كائن الإكمال. تدعم واجهة برمجة التطبيقات المعلمات القياسية مثل stop sequences و seed للتكرار. يجب أن يأخذ التعامل مع الأخطاء في الاعتبار حدود المعدل وتوفر الرصيد.
استجابات البث عبر SSE
فعّل البث عن طريق تعيين stream: true في طلبك. يعيد الواجهة البرمجية أحداث الإرسال من الخادم (SSE) لتسليم الرموات في الوقت الفعلي. تحتوي كل شريحة على محتوى جزئي، مما يسمح لك بعرض المخرجات أثناء توليدها. تتضمن الشريحة الأخيرة إجمالي استخدام الرموات لشفافية الفواتير.
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)يقلل التدفق من زمن الاستجابة المُدرَك للمستخدمين الذين ينتظرون استجابات طويلة. يمكنك معالجة الرموز تدريجياً أو تخزينها للاستخدام لاحقاً. يدعم نافذة السياق ما يصل إلى 100,000 رمز للمدخلات والإكمال معاً.
الحدود والأخطاء
راقب استخدامك مقابل حدود معدل الطلب وأرصدة الرصيد الصارمة. يمكنك إرسال 300 طلب في الدقيقة و 8 طلبات متزامنة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تشير أخطاء مثل 401 إلى مفتاح غير صالح، بينما يعني 402 أنك بحاجة إلى إعادة الشحن. تشير أخطاء 429 إلى أنك تجاوزت حد معدل الطلب. أعد الشحن بالعملات المشفرة فقط، بدءاً من $20، لمواصلة استخدام الخدمة دون انقطاع.
