الرئيسية/الوكلاء
مختبر واجهة برمجة تطبيقات متوافقة مع OpenAI: تحقق من أي نقطة نهاية

لا تحتاج إلى مختبر واجهة برمجة تطبيقات متوافق مع openai خاص للتحقق من نقطة نهاية. أربع طلبات ونص برمجي قصير ببايثون يخبرك ما إذا كان عنوان URL الأساسي يتصرف حقًا مثل واجهة برمجة تطبيقات OpenAI.
تم التحديث
نقاط رئيسية
- ابدأ بطلب GET /v1/models، ثم أجرِ إكمال دردشة أساسية واحدة.
- اختبر البث المتدفق واقرأ بيانات الاستخدام في نهاية البث.
- أرسل طلبات خاطئة عن قصد لترَ كيف تبدو الأخطاء.
- يمكن لبرنامج نصي واحد تشغيل جميع الفحوصات وطباعة النتيجة (نجاح أو فشل).
الفحوصات الأربعة ذات الأهمية
تقول العديد من الخدمات إنها متوافقة مع OpenAI. بعضها ينسخ فقط مسار المحادثة، وبعضها يغير تنسيق الأخطاء، وبعضها يتجاهل تفاصيل البث. يجب على المختبر تأكيد ما يعتمد عليه كود العميل الخاص بك:
- المصادقة والاكتشاف:
GET /v1/modelsباستخدام مفتاح Bearer. - إكمال دردشة أساسي:
POST /v1/chat/completions. - البث المتدفق: نفس الطلب مع
stream: true. - الأخطاء: ما يعود عند استخدام مفتاح خاطئ، أو اسم نموذج غير صحيح، أو جسم طلب غير صالح.
تستخدم الأمثلة أدناه نقطة النهاية الخاصة بهذا الموقع، https://api.uncensoredapis.com/v1، والنموذج uncensored. استبدل عنوان URL الأساسي والنموذج بما تختبره. إذا لم يكن لديك مفتاح بعد، أنشئ واحداً هنا؛ يمكن للحسابات الجديدة المطالبة برصيد تجريبي بقيمة $0.50 بدون بطاقة.
الفحص 1: سرد النماذج باستخدام curl
export API_KEY="sk-your-key"
curl -s -w "\nHTTP %{http_code}\n" \
https://api.uncensoredapis.com/v1/models \
-H "Authorization: Bearer $API_KEY"
توقع HTTP 200 وجسم JSON يحتوي على مصفوفة data. يحتوي كل عنصر على id. هنا، المعرف الذي ستستخدمه في كل مكان هو uncensored. يتحقق هذا الطلب من DNS وTLS ومسار الأساس والمفتاح، لذا إذا فشل، فلا فائدة من اختبار أي شيء آخر. الأسباب الشائعة هي وجود /v1 مفقود في عنوان URL الأساسي، أو وجود شرطة مائلة زائدة في النهاية، أو نسخ المفتاح مع سطر جديد.
الفحص 2: طلب محادثة بسيط واحد
curl -s https://api.uncensoredapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ok."}]}'
في الرد، تحقق من choices[0].message.content، وfinish_reason، وكائن usage الذي يحتوي على عدد رموز الموجّه وإكمال المحادثة. استخدم الرؤوس أيضاً: أضف -i وابحث عن X-Request-Id، وX-Balance-USD، وX-RateLimit-Limit-Requests، وX-RateLimit-Limit-Concurrency. وهي مفيدة للتسجيل وتتبع التكلفة لاحقاً. تقبل الخدمة نفسها أيضاً POST /v1/responses، وهو ما يغطيه شرح مرجع API.
الفحص 3: برنامج Python يختبر كل شيء
curl جيد للنظرة الأولى، لكن البرنامج النصي الذي يمكنك إعادة تشغيله بعد كل تغيير أفضل. يستخدم هذا البرنامج النصي الحزمة الرسمية openai ويقدم تقريراً عن كل فحص.
import sys
from openai import OpenAI, AuthenticationError, NotFoundError, RateLimitError
BASE = "https://api.uncensoredapis.com/v1"
MODEL = "uncensored"
client = OpenAI(base_url=BASE, api_key=sys.argv[1])
def check(name, fn):
try:
print("PASS", name, "-", fn())
except Exception as e:
print("FAIL", name, "-", type(e).__name__, e)
def models():
ids = [m.id for m in client.models.list().data]
assert MODEL in ids, ids
return ids
def chat():
r = client.chat.completions.create(
model=MODEL, messages=[{"role": "user", "content": "Say ok."}])
assert r.choices[0].message.content
return r.usage.total_tokens
def stream():
parts, usage = [], None
for c in client.chat.completions.create(
model=MODEL, stream=True,
messages=[{"role": "user", "content": "Count to five."}]):
if c.choices and c.choices[0].delta.content:
parts.append(c.choices[0].delta.content)
usage = getattr(c, "usage", None) or usage
assert parts
return f"{len(parts)} chunks, usage={usage}"
def bad_model():
try:
client.chat.completions.create(
model="no-such-model", messages=[{"role": "user", "content": "hi"}])
except NotFoundError as e:
return "NotFoundError " + str(e.status_code)
except Exception as e:
return type(e).__name__
raise AssertionError("bad model name was accepted")
for n, f in [("models", models), ("chat", chat), ("stream", stream), ("bad model", bad_model)]:
check(n, f)
شغله باستخدام python tester.py sk-your-key. يسجل فحص النموذج الخاطئ فئة الخطأ التي يرمي بها SDK الخاص بك، وهي معلومات مفيدة بحد ذاتها. إذا كانت الخدمة تقبل اسم نموذج غير معروف، فمن المحتمل أنها تعيد توجيهه أو تستخدم اسم مستعار له، ويجب أن تعرف كيف.
الفحص 4: معالجة الأخطاء
سيرى تطبيقك حالات فشل، لذا افحصها عن قصد.
- مفتاح خاطئ: غيّر حرفاً واحداً في المفتاح. توقع HTTP 401 وجسم خطأ JSON، وليس صفحة HTML.
- جسم غير صالح: أرسل
{"model":"uncensored"}بدون رسائل. توقع خطأ 4xx مع رسالة قابلة للقراءة. - حدود المعدل: تُعيد هذه الـ API رمز 429 مع الكود
rate_limitedلطلبات الدقائق، وconcurrencyلعدد كبير جداً من الطلبات المتزامنة. يؤدي الحمل الزائد المؤقت أيضاً إلى إرجاع 429، معRetry-After: 5.
يعامل العميل الجيد رمز 429 كإشارة للانتظار وإعادة المحاولة، ويعامل أخطاء 4xx الأخرى (بخلاف 429) كخطأ برمجي يجب إصلاحه. اكتب قاعدة إعادة المحاولة مرة واحدة واختبرها بإطلاق عشرة طلبات في نفس الوقت. حدود كل نوع مفتاح موجودة في صفحة الأخطاء وحدود المعدل.
فجوات التوافق التي يجب البحث عنها
اجتياز الفحوصات الأربع هو بداية جيدة. هذه هي النقاط التي تختلف فيها النسخ المقلدة في الغالب، لذا اختبر كل واحدة منها إذا كان تطبيقك يعتمد عليها:
- المعاملات: أرسل
temperature،top_p،stop،seedوعقوبات التكرار. تتجاهل بعض الخوادم بعضها بصمت. شغّل نفس الموجّه ثلاث مرات باستخدامseedثابت ودرجة حرارة منخفضة وقارن المخرجات. - أدوار الرسائل: جرّب رسالة
systemأولاً، ثم سجل محادثة طويلة متعددة المراحل. تحقق من أن رسالة النظام تغير السلوك فعلياً. - استدعاء الأدوات: اطلب استدعاء دالة عرّفتها بنفسك، ثم أرسل النتيجة مرة أخرى كرسالة
role: "tool". في وضع البث المتدفق، تصل أجزاءtool_callsبشكل متقطع ويجب عليك دمجها. - وضع JSON: اضبط
response_formatعلى{"type":"json_object"}وقم بتحليل 20 ردًا. - حجم الجسم: تقبل هذه الواجهة أجساماً بحجم يصل إلى 8 ميجابايت. يجب أن يفشل الطلب الذي يتجاوز الحد بوضوح برمز 4xx، دون أن يتوقف عن الاستجابة.
اكتب كل فجوة تجدها وقرر ما إذا كان كودك يمكنه تجاوزها. احتفظ بالملاحظات بجانب البرنامج النصي، لأنه في المرة القادمة التي يصدر فيها المزود تحديثاً، ستريد إعادة تشغيل الفحوصات نفسها ومقارنتها. إذا اختبرت عدة مزودين، شغّل البرنامج النصي نفسه ضد كل واحد منهم واحتفظ بالمخرجات في جدول، حتى تكون الفروقات واضحة بلمحة بصر بدلاً من أن تختفي في الذاكرة. عادةً ما يكون فقدان معامل غير ضار. أما اختلاف تنسيق الأخطاء أو تعطل البث المتدفق فعادةً ما يكون مشكلة.
ما لا يثبته النجاح
يعرض اجتياز الفحوصات توافق البروتوكول. لا يخبرك شيئاً عن جودة الإجابات، أو السرعة تحت الحمل، أو السعر. هذه تحتاج إلى اختبارات منفصلة باستخدام الموجّهات الخاصة بك. إضافة سريعتان تستحقان التنفيذ: طلب بموجّه طويل قريب من حجمك الحقيقي (هذه نقطة النهاية تدعم نافذة سياق بحجم 100,000 رمز)، وطلب استدعاء أداة إذا كان تطبيقك يستخدم وكلاء.
كما ضع في اعتبارك ما تختبره. تستضيف هذه الخدمة نموذجًا واحدًا مفتوح الأوزان، مُعدّ للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. يدعم النص فقط وليس API الرسمي لأي بائع نماذج. الأسعار هي $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج، مذكورة في صفحة الأسعار، ولا تُحسب تكاليف الطلبات الفاشلة، لذا فإن عمليات الاختبار المتكررة تكلف القليل جدًا. يدرج الدليل كل معلمة مدعومة.
المزيد من الأدلة
أسئلة وأجوبة
هل هناك أداة عبر الإنترنت لاختبار نقطة نهاية متوافقة مع OpenAI؟
أي عميل HTTP يعمل: curl، Postman، أو برنامج نصي قصير مع SDK الخاص بـ OpenAI. ميزة البرنامج النصي هي إمكانية إعادة تشغيله بعد كل تغيير.
ما هو عنوان URL الأساسي الذي يجب أن أضعه في الـ SDK؟
استخدم عنوان URL الكامل بما في ذلك /v1، على سبيل المثال https://api.uncensoredapis.com/v1. لا تضيف /chat/completions، لأن الـ SDK يضيفها تلقائياً.
لماذا أحصل على خطأ 404 في طلب يبدو صحيحاً؟
السبب الأكثر شيوعاً هو عنوان URL أساسي بدون /v1 أو مع مسار مكرر. تحقق منه بإرسال طلب GET إلى /v1/models أولاً.
كيف أتحقق من رصيدي المتبقي أثناء الاختبار؟
اقرأ رأس X-Balance-USD في أي استجابة، أو قم باستدعاء GET /v1/balance.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.