AR ▾
احصل على مفتاح API

بدائل واجهة برمجة تطبيقات OpenAI: ما الذي يتغيّر في الكود الخاص بك

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

تم التحديث

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

ما الذي تقدمه البدائل

يبحث الناس عن بدائل لواجهة برمجة التطبيقات (API) الخاصة بـ OpenAI لأسباب مختلفة: السعر، وقواعد المحتوى، ومعالجة البيانات، والتوافر الإقليمي، أو الرغبة في استخدام نماذج مفتوحة الأوزان. بغضّ النظر عن السبب، فإن الاختبار نفسه ينطبق: هل تقبل البديلة شكل الطلب الذي ترسله بالفعل، وهل تُرجع شكل الاستجابة الذي يقرأه كودك بالفعل؟

إذا كانت الإجابة بنعم، فإن استدعاءات SDK لا تتغير. إذا لم تكن كذلك، فإنك تكتب محوّلًا مرة واحدة، وهو أمر جيد أيضًا، لكنه التكلفة الرئيسية للتبديل. يفترض هذا المقال الحالة الأولى، وهي نقطة نهاية متوافقة مع OpenAI.

التغيير المكون من ثلاثة أسطر

مع الحزمة الرسمية لـ Python، يحتوي الإعداد الأصلي على المضيف الافتراضي ومفتاح OpenAI. بالنسبة إلى البديل، تضبط ثلاثة أشياء: base_url، والمفتاح من المزوّد الجديد، واسم النموذج. إليك النسخة النهائية لهذه نقطة النهاية:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",  # was the default host
    api_key=os.environ["NEW_PROVIDER_KEY"],            # was your OpenAI key
)

r = client.chat.completions.create(
    model="uncensored",                                 # was an OpenAI model name
    messages=[{"role": "user", "content": "Pitch me a plot twist for a mystery."}],
)
print(r.choices[0].message.content)

نفس الأمر يعمل في Node.js بتمرير baseURL إلى المُهيّئ، في أغطية على نمط LangChain عبر خيار عنوان URL الأساسي، وفي الأدوات التي تحتوي على حقل نقطة نهاية مخصص. في curl، تُغيّر المضيف والرأس:

curl https://api.uncensoredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $NEW_PROVIDER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

ما الذي قد ينكسر بعد التبديل

أسماء النماذج

معرفات النماذج مملوكة للمزوّد. أي كود يربط اسم نموذج OpenAI بشكل ثابت يحتاج إلى تحديث. ضع الاسم في ملف التكوين.

المعاملات

الخيارات الأساسية مثل temperature وtop_p وstop وmax_tokens تنتقل كما هي. خيارات أخرى، مثل logprobs أو خيارات تنسيق الاستجابة المحددة، تعتمد على المزوّد. في هذه نقطة النهاية، تُمرَّر temperature وtop_p وstop وseed والعقوبات كما هي، ويعمل وضع JSON مع response_format: {"type":"json_object"}.

جودة استدعاء الأدوات

تنسيق السلك مشترك، لكن كيفية اختيار النموذج للأدوات وملء الحجج تختلف. شغّل مخططات الأدوات الحقيقية الخاصة بك عبر النموذج الجديد، وحقّق من الحجج في كودك.

طول السياق والقطع

يغيّر تغيير نافذة السياق مقدار السجل الذي يمكنك إرساله. هنا، حجم النافذة هو 100,000 رمز للموجّه بالإضافة إلى الإكمال.

الأخطاء والحدود

يستخدم المزوّدون حدودًا وأكوادًا مختلفة. يُرجع هذا المزوّد HTTP 429 مع rate_limited للطلبات في الدقيقة وconcurrency للطلبات المتعددة في وقت واحد، و429 مع Retry-After: 5 عند الحمل الزائد المؤقت. يجب أن يتعامل منطق إعادة المحاولة مع 429 لأي مزوّد.

السلوك

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

أين تناسب نقطة النهاية ذات النموذج الواحد

هذه الخدمة هي واجهة نصية متوافقة مع OpenAI مع نموذج واحد مفتوح الأوزان، تشغله جهة مستقلة ومُضبوطة للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. ليست واجهة OpenAI الرسمية، ولا Meta، ولا Mistral، ولا Qwen، ولا DeepSeek، ولا xAI، ولا Google، ولا Anthropic، ولا أي مورد آخر، وليست موزّعة عبر الموردين. معرف النموذج هو uncensored.

تناسب هذه المهام جيدًا: أدوات الخيال الأدبي ولعب الأدوار للبالغين، وتطبيقات الرفيق، ومساعدو الكتابة الذين لا يجب أن يتوقفوا في منتصف المشهد، والخوادم الخلفية التي يكون فيها السلوك المستقر على المواضيع الناضجة مهمًا أكثر من الاختيار بين العديد من النماذج. كما تناسب المطورين الذين يريدون سعرًا بسيطًا لكل رمز وموجّهات لا تُستخدم للتدريب.

حيث لا يناسب

كن صادقًا بشأن الحدود قبل نقل حركة المرور:

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

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

التكلفة: كيفية المقارنة

تحقّق من أسعار كل مورد حاليًا وحوّلها إلى شكل طلبك. بالنسبة إلى نقطة النهاية هذه، تكلف المدخلات $0.15 لكل مليون رمز والمخرجات $0.50 لكل مليون. مثال: 3,000 رمز مدخل و500 رمز مخرج تكلف $0.00045 + $0.00025 = $0.0007 لكل استدعاء، لذا فإن 10,000 استدعاء في الشهر تكلف $7. الطلبات الفاشلة أو المرفوضة لا تُحتسب، لا يوجد اشتراك، ولا ينفد الرصيد أبداً.

تعمل الإضافات من $20 إلى $500، بالعملات المشفرة (USDT على TRC20، USDC على Base)، مع مكافأة +5% من $50، و+10% من $100، و+15% من $200. للحصول على جدول يوضح كيف تتنافس خيارات النماذج المختلفة، انظر مقارنة نماذج الذكاء الاصطناعي والأسعار. يحتوي صفحة الأسعار على القائمة الكاملة.

نمط الاستجابة الاحتياطية لنقطتي نهاية

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

import os
from openai import OpenAI

main = OpenAI(api_key=os.environ["MAIN_KEY"])
second = OpenAI(
    base_url="https://api.uncensoredaimodels.com/v1",
    api_key=os.environ["NEW_PROVIDER_KEY"],
)

def ask(messages, main_model, use_second_first=False):
    order = [(second, "uncensored"), (main, main_model)] if use_second_first else [(main, main_model), (second, "uncensored")]
    last = None
    for client, model in order:
        try:
            r = client.chat.completions.create(model=model, messages=messages)
            return r.choices[0].message.content
        except Exception as err:
            last = err
    raise last

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

طريقة آمنة للاختبار

لا تنقل كل الطلبات دفعة واحدة. احصل على رصيد تجريبي مجاني بقيمة $0.50 في صفحة مفتاح API، الذي لا يحتاج بطاقة ويستمر 7 أيام، ثم نفذ هذه الخطوات:

  1. أعد تشغيل 20 موجّه حقيقي من سجلاتك على نقطة النهاية الجديدة.
  2. قارن الإجابات، وعدد الرموز، والأخطاء مع مزوّدك الحالي.
  3. أجبر حدوث خطأ 429 وتأكد من أن إعادة المحاولة تعمل.
  4. أرسل 5% من طلبات الإنتاج عبر علم ميزة.
  5. راقب رأس X-Balance-USD ومعدل الأخطاء لديك لبضعة أيام قبل التوسيع.

تغطي الوثائق الأساليب، ويوضح LLM للبرمجة بدون رقابة استخداماً واحداً للمطورين بالتفصيل.

01

أسئلة وأجوبة

هل يمكنني استخدام OpenAI SDK مع مورد آخر؟

نعم، إذا كان المورد متوافقاً مع OpenAI. اضبط عنوان URL الأساسي والمفتاح واسم النموذج لقيم المورد الجديد.

هل هذه الخدمة هي واجهة برمجة OpenAI؟

لا. إنها نقطة نهاية مستقلة متوافقة مع OpenAI تشغل نموذجاً واحداً مفتوح الأوزان، وليست واجهة برمجة رسمية من OpenAI أو أي مورد آخر.

هل يدعم البث المتدفق والأدوات؟

نعم. يعمل البث المتدفق عبر SSE مع stream: true، ويستخدم استدعاء الدوال تنسيق الأدوات وtool_calls القياسي.

ماذا يجب أن أتحقق منه قبل التبديل؟

أسماء النماذج، المعاملات المدعومة، سلوك استدعاء الأدوات، حدود السياق، معالجة أخطاء 429، وأهمّ من ذلك، كيف يجيب النموذج على موجّهاتك الحقيقية.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذا هو الإعداد الكامل.

احصل على مفتاح API