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

بديل OpenAI للمطوّرين: إعداد مفتاح API وSDK

بديل واجهة برمجة تطبيقات OpenAI بدون رقابة

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

تم التحديث

طرفية متصلة بكابل متوهج بمكعب واحد، توضح تغيير نقطة النهاية للمطوّرين

نقاط رئيسية

خمس خطوات من الصفر إلى استدعاء يعمل

إذا كنت تريد بديل OpenAI للمطوّرين يمكنك اختباره اليوم، فهذا هو المسار الكامل. يستغرق حوالي عشر دقائق.

  1. أنشئ حسابًا باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور.
  2. افتح صفحة مفتاح API واضغط على الزر الذي يستحصل على رصيد التجربة. تحصل على $0.50، ساري لمدة 7 أيام، لكل شخص واحد، بدون بطاقة.
  3. انسخ المفتاح. عامله مثل كلمة المرور واحفظه بعيدًا عن git.
  4. عيّن عنوان URL الأساسي إلى https://api.openaiapialternative.com/v1 في الـ SDK أو العميل الخاص بك.
  5. أرسل طلبًا مع ضبط النموذج على uncensored.

باقي التفاصيل، بما في ذلك تنسيق الرسائل، والبث المتدفق، واستدعاء الأدوات، هي نفسها تنسيق إكمال الدردشة الخاص بـ OpenAI الذي تستخدمه بالفعل. الخدمة تعرض POST /v1/chat/completions وGET /v1/models. لا شيء أكثر، لذا لا يوجد الكثير لتعلمه.

Python مع الـ SDK الرسمي

ثبّت الحزمة باستخدام pip install openai. يأخذ العميل عنوان URL الأساسي والمفتاح كوسيطي بناء، لذا لا يتم تعديل الحالة العامة ويمكنك الاحتفاظ بعميل ثانٍ لمزود آخر في نفس العملية.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.openaiapialternative.com/v1",
    api_key=os.environ["UNCENSORED_API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "Answer briefly and directly."},
        {"role": "user", "content": "List three edge cases for a date parser."},
    ],
    max_tokens=300,
)
print(resp.choices[0].message.content)
print(resp.usage)

max_tokens اختياري. إذا لم تحددّه، فقد يستخدم الإكمال المساحة المتبقية من نافذة الـ 100,000 رمز، لذا حدّد حدًا أقصى عندما تريد تكلفة متوقعة.

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

from openai import OpenAI

client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
history = [{"role": "system", "content": "You are a patient pair-programming partner."}]

while True:
    user = input("you> ")
    if not user:
        break
    history.append({"role": "user", "content": user})
    r = client.chat.completions.create(model="uncensored", messages=history)
    answer = r.choices[0].message.content
    history.append({"role": "assistant", "content": answer})
    print(answer)

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

Node و curl

يتبع الـ Node SDK نفس النمط. ثبّته باستخدام npm install openai ومرر baseURL.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.openaiapialternative.com/v1",
  apiKey: process.env.UNCENSORED_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about stack traces." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

لإجراء فحص سريع من الطرفية، اطلب قائمة النماذج. يجب أن ترى عنصرًا واحدًا بمعرف uncensored.

# expect one entry with id "uncensored"
curl https://api.openaiapialternative.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_API_KEY"

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

المحررات، الوكلاء، والعملاء الآخرون

تسمح العديد من أدوات المطورين بتجاوز عنوان URL الأساسي الخاص بـ OpenAI. محررات مثل Cursor تحتوي على شاشة إعدادات النموذج حيث يمكنك إدخال عنوان URL الأساسي متوافق مع OpenAI ومفتاح، وتسمح واجهات الدردشة الأمامية مثل SillyTavern بإضافة نقطة نهاية متوافقة مع OpenAI. تتغير التسميات ومواقع القوائم بين الإصدارات، لذا ابحث عن حقل باسم "تجاوز عنوان URL الأساسي لـ OpenAI" أو "نقطة نهاية مخصصة".

بغض النظر عن الأداة، تحتاج إلى نفس القيم الثلاثة:

الحقلالقيمة
عنوان URL الأساسيhttps://api.openaiapialternative.com/v1
مفتاح APIالمفتاح من حسابك
اسم النموذجuncensored

إذا أصرّ الأداة على قائمة بأسماء النماذج المعروفة، أضف uncensored كنموذج مخصص. إذا أضاف /v1 تلقائيًا، زوّد العنوان بدون اللاحقة، وإلا ستحصل على مسار مكرر وخطأ "Not Found".

استدعاء الدوال ووضع JSON

الإخراج الهيكلي هو المكان الذي عادةً ما تنكسر فيه البدائل، لذا اختبره مبكرًا. كلا الميزتين تستخدمان تنسيق OpenAI. لوضع JSON، اضبط response_format واذكر JSON في الموجّه.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[
        {"role": "system", "content": "Reply with a JSON object with keys title and tags."},
        {"role": "user", "content": "Describe a short story about a lost lighthouse keeper."},
    ],
)
data = json.loads(resp.choices[0].message.content)
print(data["title"], data["tags"])

للأدوات، مرر قائمة tools مع مخططات الدوال، اقرأ tool_calls من الرد، شغّل الدالة بنفسك وأرسل النتيجة مرة أخرى كرسالة مع role: "tool". تستجيب الاستجابات المتدفقة بـ tool_calls على أجزاء، لذا اجمع نص الوسيطات قبل تحليله.

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

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

الحدود، التعامل مع 429، والتحكم في التكلفة

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 و60. يمكن أن يصل حجم الجسم إلى 8 ميجابايت. تحمل كل استجابة الرؤوس X-RateLimit-Limit-Requests وX-RateLimit-Limit-Concurrency، بالإضافة إلى X-Balance-USD لرصيدك المتبقي.

تجاوز الحدّ يعيد HTTP 429. رمز الخطأ يخبرك أي حدّ: rate_limited يعني طلبات كثيرة في الدقيقة، وconcurrency يعني طلبات كثيرة في آنٍ واحد. الحمل الزائد المؤقت يعيد أيضًا 429، مع رأس Retry-After: 5. مكتبات OpenAI SDK تعيد محاولة استجابات 429 افتراضيًا مع تراجع، ويمكنك رفع العدد مع max_retries في العميل. للوظائف الدفعية، يضمن المسموح (semaphore) بقيمة 8 أن تبقى تحت حدّ التوازي.

لأغراض الميزانية، اعتمد على السعر: $0.15 لكل مليون رمز مدخل و$0.50 لكل مليون رمز مخرج. مهمة ترسل 4 ملايين رمز مدخل وتحصل على 1 مليون رمز مخرج تكلف 4 × $0.15 + 1 × $0.50 = $1.10. الطلبات الفاشلة أو المرفوضة لا تُحسب. يعرض صفحة التسعير أحجام شحن الرصيد والمكافآت.

يكفي غلاف إعادة محاولة قصير إذا لم تكن تستخدم SDKً يعيد المحاولة نيابةً عنك. اقرأ Retry-After عند وجوده، واستعن بتأخير أسي كحل بديل، واستسلم بعد بضع محاولات. لا تُعد المحاولة في حال الأخطاء التي ليست 429 أو خطأً في الخادم، لأن الطلب غير الصحيح سيفشل بنفس الطريقة في كل مرة.

أخطاء تكلف ساعة في اليوم الأول

تأتي معظم المكالمات الفاشلة في المرة الأولى من قائمة قصيرة من الأسباب. تحقق من هذه قبل أن تشك في الخدمة.

  • مسار مكرر. عنوان URL الأساسي ينتهي بالفعل بـ /v1. لا تضيف آخر، ولا تستدعي /chat/completions بدونه.
  • اسم النموذج الخاطئ. غالباً ما يحمل الكود القديم اسم نموذج من مورد آخر. استبدله بـ uncensored، وإلا لن تتطابق المكالمة مع أي شيء.
  • مفتاح يحتوي على مسافات بيضاء. غالباً ما تتضمن المفاتيح المنسوخة من صفحة ويب أو طرفية سطر جديد في النهاية. احذفه.
  • اختبارات على مفتاح تجريبي بتزامن إنتاجي. يسمح المفتاح التجريبي بـ 2 طلب متزامن و60 طلب في الدقيقة، لذا سيعيد اختبار حمل بـ 20 خيطاً رمز الخطأ 429 مع الكود concurrency تقريباً في الحال.
  • توقع نقاط نهاية أخرى. مكالمات الصور والصوت والتضمين ليست جزءاً من الخدمة.

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

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

قبل النشر

  • احتفظ بالمفتاح على الخادم. لا ترسله أبداً في حزمة متصفح أو تطبيق جوال.
  • سجّل رأس X-Request-Id مع كل مكالمة. هذا يجعل أسئلة الدعم قابلة للإجابة.
  • أضف تصفية المدخلات والمخرجات الخاصة بك إذا كان المستخدمون النهائيون يمكنهم الكتابة بحرية. النموذج لن يرفض، لذا فإن الرقابة (moderation) هي ما عليك تعريفها.
  • احتفظ بموفر احتياطي في التكوين. التبديل هو مجرد تغيير في عنوان URL الأساسي، لذا يكفي مفتاح ميزة.
  • تذكر النطاق: نصوص فقط، بدون تضمين، بدون صور، بدون ضبط دقيق.

تحتوي الوثائق على القائمة الكاملة للمعاملات. إذا تصرف شيء بشكل غريب، فإن صفحة الدعم تخبرك بكيفية الوصول إلى الفريق.

أسئلة وأجوبة

أي SDKs تعمل؟

أي عميل أو SDK من OpenAI يتيح لك تعيين عنوان URL الأساسي والمفتاح. تعمل المكتبات الرسمية لـ Python وNode.js، وكذلك استدعاءات HTTP العادية مع curl.

هل أحتاج إلى بطاقة لتجربته؟

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

ما هو اسم النموذج؟

معرف النموذج هو uncensored. قم باستدعاء GET /v1/models للتأكد من ذلك باستخدام مفتاحك الخاص.

ما هو الحد الأقصى لحجم الطلب؟

نافذة السياق هي 100,000 رمز للموجّه والإكمال معاً، وحجم جسم الطلب الأقصى هو 8 MB.

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

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

احصل على مفتاح APIاقرأ التوثيق