كيفية استخدام واجهة برمجة تطبيقات متوافقة مع OpenAI في 5 خطوات
استخدام واجهة برمجة تطبيقات على طراز OpenAI يتطلب خمس خطوات: احصل على مفتاح، ثبّت SDK، وجّهه إلى عنوان URL الأساسي الصحيح، وحدد اسم نموذج وأرسل الرسائل. إليك كل خطوة مع كود يمكنك لصقه.

نقاط رئيسية
- أي SDK من OpenAI يعمل هنا بمجرد تغيير عنوان URL الأساسي إلى https://api.uncensoredaiapis.com/v1 واستخدام مفتاحك الخاص.
- معرف النموذج هو uncensored؛ المسارات الرئيسية هي POST /v1/chat/completions وGET /v1/models.
- يستخدم البث، ووضع JSON، واستدعاء الدوال نفس المعلمات الموجودة في واجهة برمجة التطبيقات الرسمية.
- التسعير هو $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج، ويمكنك البدء برصيد تجريبي بقيمة $0.50.
النسخة المختصرة
إذا كنت تريد معرفة كيفية استخدام مكالمات واجهة برمجة التطبيقات الخاصة بـ openai مع خدمة ليست من OpenAI، فإن الإجابة هي أن تنسيق الطلب هو اتفاقية مشتركة. يحتاج العميل الذي يتعامل معها إلى ثلاث قيم: مكان إرسال الطلبات (عنوان URL الأساسي)، ومن أنت (المفتاح)، والنموذج الذي تريد تشغيله. غيّر هذه القيم الثلاث وستعمل نفس الشيفرة. يتبع هذا الموقع تلك الاتفاقية، لذا تعمل حزم Python و Node.js القياسية، و curl العادي، ضدها جميعًا.
كن واضحًا بشأن ما يعنيه هذا وما لا يعنيه. التوافق يعني تطابق الواجهة. لا يعني ذلك أن هذه هي خدمة OpenAI الرسمية أو أنها تشغل نماذج OpenAI. الخلفية هي نموذج واحد مفتوح الأوزان، تشغله مزود مستقل ومضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، وتختاره باستخدام معرف النموذج uncensored. يتعامل مع النصوص فقط: لا صور، ولا صوت، ولا تضمينات، ولا ضبط دقيق.
تستغرق الخطوات الخمس أدناه حوالي عشر دقائق. إذا كنت تفضل قراءة مقتطفات جاهزة بلغات متعددة، راجع صفحة أمثلة الشيفرة.
الخطوة 1: احصل على مفتاح
سجّل باستخدام Google، أو بالبريد الإلكتروني وكلمة المرور، وافتح صفحة مفتاح API. يمكن للمستخدمين الجدد المطالبة برصيد $0.50 تجريبي بنقرة واحدة. صالح لمدة 7 أيام، محدود بنسخة واحدة لكل شخص، ولا يحتاج إلى بطاقة. انسخ المفتاح واحفظه كمتغير بيئة بدلاً من لصقه في الشيفرة:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"مفتاح التجربة محدود بـ 2 طلب متزامن و60 طلبًا في الدقيقة. المفتاح الممول يسمح بـ 8 متزامن و300 في الدقيقة. تفاصيل ما تتضمنه التجربة موجودة في أسئلة التجربة المجانية.
الخطوة 2: تثبيت SDK وإرسال الطلب الأول
ثبّت الحزمة الرسمية للغتك. كلاهما نفس المكتبات التي ستستخدمها لأي خدمة على طراز OpenAI:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiالآن أول مكالمة في Python. الفرق الوحيد عن الإعداد الافتراضي هو وسيط base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)ونفس الاستدعاء في Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);الخطوة 3: فهم مصفوفة الرسائل
نماذج الدردشة لا تتذكر أي شيء بين المكالمات. يحمل كل طلب المحادثة الكاملة كقائمة من الرسائل، ولكل رسالة دور.
- يحدد
systemالسلوك والأسلوب. ضع الشخصية وقواعد التنسيق والقيود هنا. - يحتوي
userعلى ما سأله الشخص. - يحتوي
assistantعلى ردود النموذج السابقة. تضيفها بنفسك عند متابعة المحادثة. - يحمل
toolنتيجة استدعاء الدالة، وهو مغطى أدناه.
لمتابعة الدردشة، ألصق رد المساعد ورسالة المستخدم التالية في نفس القائمة وأرسلها مرة أخرى. هذا هو سبب تكلفة المحادثات الطويلة: تدفع كل مكالمة مقابل السجل الكامل كرموز مدخلة. تتسع نافذة السياق لـ 100,000 رمز في المجموع، للموجه والإكمال معًا، لذا فإن تقصير الأدوار القديمة جزء طبيعي من بناء تطبيق دردشة.
حقول أخذ العينات المفيدة تُمرر عبر: temperature، top_p، stop، seed وعقوبات التكرار والوجود. max_tokens اختياري. اضبطه عندما تريد تحديد طول الرد والإنفاق.
الخطوة 4: البث المتدفق، وضع JSON والأدوات
البث المتدفق
أضف stream: true لتلقي الرموز كأحداث مرسلة من الخادم. يجعل الواجهات سريعة، حيث يظهر النص بينما لا يزال النموذج يكتب، ويبلغ عن الاستخدام في نهاية البث.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}وضع JSON
استخدم response_format: {"type": "json_object"} عندما يقوم كودك بتحليل الرد. صف المفاتيح المطلوبة في الموجّه أيضًا.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'استدعاء الدوال
مرر قائمة tools مع مخططات الدوال، و اختياريًا tool_choice. عندما يريد النموذج تشغيل دالة، يحتوي الرد على tool_calls. تقوم بتشغيل الدالة في كودك الخاص وترسل المخرجات مرة أخرى كرسالة مع الدور tool. تستمر استدعاءات الأدوات أيضًا في البث. هذا هو المكون الأساسي للوكلاء؛ تظهر صفحة حالات الاستخدام أين يكون ذلك مجديًا.
الخطوة 5: معرفة الحدود والتكاليف والأخطاء
عبر الحد، تعيد واجهة برمجة التطبيقات HTTP 429. رمز الخطأ هو rate_limited لعدد كبير جدًا من الطلبات في الدقيقة و concurrency لعدد كبير جدًا في وقت واحد. يعطي الحمل الزائد المؤقت أيضًا 429، مع رأس Retry-After: 5. يحافظ الطلب المتدفق على فتحة التزامن حتى ينتهي البث، لذا أغلق البث الذي لم تعد تقرأه. حد حجم جسم الطلب هو 8 MB. يحمل كل استجابة رؤوس X-Request-Id و X-Balance-USD، والأول هو ما تذكره للدعم.
التكلفة بسيطة. مكالمات الدردشة التي تحتوي على 3,000 رمز إدخال و700 رمز إخراج تكلف 3,000 × $0.15 لكل مليون، أي $0.00045، بالإضافة إلى 700 × $0.50 لكل مليون، أي $0.00035، ليصبح المجموع $0.0008. تكلفة ألف مكالمة من هذا النوع هي $0.80. الطلبات الفاشلة أو المرفوضة لا تُحتسب عليك، ولا ينتهي الرصيد المسبق الدفع. صفحة التسعير تعرض شحنات الرصيد من $20 إلى $500 مع زيادة 5% من $50، و10% من $100، و15% من $200. يمكنك الدفع بالعملات المشفرة فقط (USDT على TRC20، USDC على Base).
كيف يختلف هذا عن واجهة برمجة التطبيقات الرسمية
ثلاثة اختلافات تستحق التخطيط لها. أولاً، اسم النموذج: استخدم uncensored، وليس اسم نموذج OpenAI. ثانياً، النطاق: تحصل على إكمال الدردشة وقائمة النماذج فقط، لذا فإن الميزات مثل توليد الصور، والكلام، والتضمينات، والضبط الدقيق غير متوفرة هنا. ثالثاً، السلوك: النموذج مُعدّ لعدم رفض الطلبات القانونية للبالغين، لذا قد يختلف المخرج عن مساعد مرشح بشدة. قاعدة واحدة لا تتغير أبداً: لا يوجد محتوى جنسي يتضمن القاصرين.
بعض العادات تساعدك في اليوم الأول. احتفظ بالمفتاح في متغير بيئة، وسجّل X-Request-Id لكل استدعاء، واضبط max_tokens أثناء تجربتك حتى لا ينفذ ردّ خارج عن السيطرة أكثر مما خططت له. عند بناء واجهة دردشة، قم ببث الرد وقص المحادثات القديمة بمجرد نمو السجل. عند بناء خط أنابيب يحلل المخرجات، استخدم وضع JSON واحمِ عملية التحليل، لأن الرد المقطوع عند حد الرموز ليس JSON صالحاً. وعندما يستدعي جزأان من برنامجك واجهة API في نفس الوقت، احسبها ضمن الـ 8 طلبات متزامنة التي يسمح بها المفتاح الكامل.
لا تنسَ تكلفة الاختبار. بضع عشرات من التجارب مع موجّهات قصيرة تكلف أقل من سنت واحد في المجموع، لذا فإن رصيد التجربة بقيمة $0.50 يمتد لمسافة طويلة أثناء تعلمك لتنسيق الطلب.
إذا كنت تنقل تطبيقاً موجوداً، فإن دليل الترحيل يوضح التغييرات بالترتيب. الموجّهات المرسلة هنا لا تُستخدم للتدريب. بالنسبة لمعظم التطبيقات، يتكون الترحيل من القيم الثلاث في بداية هذه الصفحة واسم النموذج.
المزيد من الأدلة
أسئلة وأجوبة
هل أحتاج إلى SDK الرسمي من OpenAI؟
يمكنك استخدامه، وهو المسار الأسهل. أي عميل متوافق مع OpenAI أو HTTP عادي يعمل أيضاً، طالما يدعم عنوان URL أساسي مخصص.
ما اسم النموذج الذي أرسله؟
أرسل uncensored. عنوان URL الأساسي هو https://api.uncensoredaiapis.com/v1.
هل هذه هي واجهة برمجة تطبيقات OpenAI الرسمية؟
لا. يتبع نفس تنسيق الطلب، لكن النموذج هو نموذج مفتوح الأوزان الذي تشغله مزود مستقل، والخدمة منفصلة عن OpenAI.
كم يكلف الطلب؟
تكلفة رموز الإدخال $0.15 لكل مليون، ورموز المخرجات $0.50 لكل مليون. طلب يحتوي على 3,000 رمز إدخال و700 رمز مخرجات يكلف حوالي $0.0008.
هل يمكنني تجربته قبل الدفع؟
نعم. بعد تسجيل الحساب يمكنك الحصول على $0.50 من رصيد تجريبي بنقرة واحدة. صالح لمدة 7 أيام ولا يحتاج إلى بطاقة.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.