نقاط رئيسية
- عنوان URL الأساسي الخاص بنا هو https://api.uncensoredgptapi.com/v1 ومعرف النموذج هو
uncensored. - تأخذ مكتبات SDK الخاصة بـ Python و Node.js معلمة base_url أو baseURL؛ وكلاهما يقرأان أيضاً متغيرات البيئة.
- تأتي معظم الأخطاء من وجود /v1 مفقود، أو مسار مكرر، أو اسم نموذج قديم.
- GET /v1/models هي أسرع طريقة للتأكد من صحة عنوان URL والمفتاح.
ما يفعله عنوان URL الأساسي
إن gpt api base_url هو العنوان الذي تضيفه مكتبات SDK الخاصة بـ OpenAI في بداية كل مسار نقطة نهاية. بشكل افتراضي، ترسل المكتبات الرسمية الطلبات إلى خوادم OpenAI. إذا قمت بتعيين عنوان URL أساسي مختلف، فإن نفس كود العميل يرسل نفس تنسيق الطلب إلى خادم آخر يتكلم نفس البروتوكول.
هذا هو كل ما يعنيه التوافق مع OpenAI عملياً. تقبل الـ API الخاص بنا POST /v1/chat/completions و GET /v1/models مع نفس أشكال JSON، ونفس رأس Authorization: Bearer ونفس تنسيق البث المتدفق. لذا عليك تغيير ثلاث قيم:
- عنوان URL الأساسي:
https://api.uncensoredgptapi.com/v1 - مفتاح API: المفتاح من لوحة التحكم الخاصة بك
- النموذج:
uncensored
خدمتنا هي خدمة مستقلة تشغل نموذجاً واحداً مفتوح الأوزان. إنها ليست API الخاصة بـ OpenAI وليست موجهاً لموردين آخرين، لذا فإن أسماء النماذج مثل gpt-4o غير موجودة هنا. استخدم uncensored في كل مكان.
Python باستخدام SDK
في مكتبة SDK الحالية لـ Python، مرر base_url عند إنشاء العميل.
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)إذا كان كودك أقدم ويستخدم openai.api_base، فهو على مكتبة SDK قبل الإصدار 1.0، حيث يكون للإعداد العالمي اسم مختلف. عادةً ما يكون ترقية الحزمة أسهل من التكيف. تحقق من الإصدار باستخدام pip show openai.
من المفيد معرفة كيفية بناء المكتبة للطلب. تأخذ عنوان URL الأساسي الخاص بك، وتلحق مسار نقطة النهاية مثل /chat/completions، وتضيف رأس Authorization: Bearer من مفتاحك. هذه هي الآلية بأكملها. عندما يفشل شيء ما، اطبع أو سجل عنوان URL النهائي، وقارنه مع أمر curl في القسم التالي.
يقبل نفس العميل إعدادات timeout و max_retries. تعيد المحاولات الافتراضية المحاولة بضع مرات عند مشاكل الاتصال، وهو أمر جيد لمعظم البرامج النصية. بالنسبة لحدّ المعدل، التقط استثناء حدّ المعدل الخاص بالمكتبة وانتظر قبل إعادة المحاولة. يحتفظ الطلب المتدفق بفتحة التزامن الخاصة به حتى ينتهي، لذا فإن موجة من البث الطويلة قد تضرب حدّ التزامن حتى عندما يكون عدد طلباتك في الدقيقة منخفضاً.
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")مدة الانتظار لمدة خمس ثوانٍ في أول محاولة إعادة المحاولة تتطابق مع قيمة Retry-After: 5 التي ترسلها الـ API عند الحمل الزائد المؤقت. الانتظار لفترة أطول في كل محاولة لاحقة يتجنب الضغط على نقطة النهاية.
Node و curl
تستخدم مكتبة SDK الخاصة بـ Node.js baseURL بحرف URL كبير.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);بدون أي مكتبة SDK، يُظهر curl بالضبط ما تفعله المكتبة. عنوان URL الكامل هو عنوان URL الأساسي زائد /chat/completions.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'قراءة هذا الأمر هي الطريقة الأوضح لفهم عنوان URL الأساسي: كل شيء حتى بما في ذلك /v1 هو الأساس، وتضيف المكتبة الباقي.
متغيرات البيئة
إذا لم تتمكن من تعديل الكود، أو تريد إعداداً واحداً لعدة برامج نصية، فإن مكتبات SDK الخاصة بـ OpenAI تقرأ OPENAI_BASE_URL و OPENAI_API_KEY من البيئة عندما لا يتم إعطاء قيمة صريحة.
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyهذا مفيد للأدوات التي لم تكتبها. أي شيء مبني على مكتبة SDK الخاصة بـ OpenAI قد يلتقط المتغيرات دون تغييرات، على الرغم من أنك لا تزال بحاجة إلى تعيين اسم النموذج إلى uncensored داخل الأداة. إذا كانت الأداة تحدد اسم النموذج بشكل ثابت، فأنت بحاجة إلى إعداد خاص بها أو تغيير في الكود.
فصل نقطتي النهاية
تختبر العديد من المشاريع ضد نقطة نهاية واحدة وتُصدر ضد أخرى، أو تتبديل بينها حسب البيئة. أبقِ القيم الثلاث خارج الكود الخاص بك واقرأها من ملف التكوين، بحيث يكون التبديل مجرد تعديل في ملف وليس تعديلًا في الكود.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")يُجنبك استخدام أسماء متغيراتك الخاصة بدلًا من الافتراضيات الموجودة في الـ SDK فخًا صامتًا: الأداة التي تقرأ OPENAI_API_KEY من الـ shell ستُرسل أي مفتاح مُعَيَّن هناك إلى أي عنوان URL أساسي مُعَيَّن بجانبه. إذا كان لديك مفتاح OpenAI قديم في ملفك الشخصي وعنوان URL أساسي جديد في مشروعك، فقد ينتهي بك الأمر بإرسال مفتاح خدمة واحدة إلى الخدمة الأخرى. فصل الأسماء يجعل ذلك مستحيلاً، ويمكنك أن ترى بوضوح أي نقطة نهاية سيستخدمها النص البرمجي.
عامل اسم النموذج كإعداد أيضًا. إنه القيمة التي تُترك غالبًا خلفك عند التبديل، وهو ما يُنتج أخطاءً مربكة للغاية، لأن كل شيء آخر يبدو صحيحًا.
يستخدم البث المتدفق والأدوات نفس العنوان الأساسي
تغيير العنوان الأساسي لا يحد من الميزات. يمر البث المتدفق، واستدعاء الدوال، ووضع JSON عبر نفس المسار /chat/completions، لذا فإن الكود الذي كان يعمل مع الـ API الأصلي سيستمر في العمل. يُعيد البث المتدفق أحداثًا مُرسلة من الخادم (SSE)، مع الإبلاغ عن الاستخدام في نهاية البث.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()يُعد التحقق من chunk.choices مهمًا. الشريحة النهائية التي تحمل بيانات الاستخدام قد لا تحتوي على خيارات، وقد يتسبب الكود الذي يقوم بالوصول إلى قائمة فارغة في تعطل البرنامج عند الرسالة الأخيرة. تُبث استدعاءات الدوال بنفس الطريقة، كقطع جزئية من tool_calls تقوم بتجميعها قبل تشغيل الدالة، وتعود النتائج كرسائل مع role: "tool". يأخذ وضع JSON response_format={"type": "json_object"}.
التطبيقات والأطر التي تحتوي على حقل لعنوان URL الأساسي
تعرض العديد من التطبيقات الإعداد نفسه تحت أسماء مختلفة: عنوان URL الأساسي لـ API، نقطة النهاية، عنوان URL مخصص لـ OpenAI، أو المضيف. القاعدة لا تتغير. الصق عنوان URL الأساسي بما فيه /v1، الصق المفتاح، واكتب uncensored كاسم للنموذج.
SillyTavern، على سبيل المثال، يتيح لك إضافة نقطة نهاية متوافقة مع OpenAI. تقبل فئة ChatOpenAI في LangChain وسيطة base_url. تسمي الواجهات الأخرى هذا الحقل بعنوان URL للوكيل أو وكيل عكسي. تختلف أسماء الحقول حسب الإصدار، لذا ابحث عن الحقل الذي يقبل عنوان URL ينتهي بـ /v1.
تطلب بعض التطبيقات نموذجًا من قائمة منسدلة يملؤها عن طريق استدعاء GET /v1/models. تعمل نقطة النهاية هذه هنا وتُرجع قائمة النماذج، لذا يجب أن تظهر القائمة uncensored بمجرد صحة عنوان URL والمفتاح. إذا ظلت فارغة، فإن عنوان URL أو المفتاح غير صحيح.
عندما يقدم التطبيق حقلًا لعنوان URL الأساسي وحقلًا لـ "المؤسسة" أو "المشروع"، اترك الحقول الإضافية فارغة. توجد هذه للخدمة الأصلية ولا تعني شيئًا هنا. إذا أصر تطبيق على مفتاح يبدأ ببادئة معينة، جرب نوع اتصال مختلف، مثل خيار متوافق مع OpenAI عام أو مخصص، بدلاً من الإعداد المسبق للخدمة الأصلية.
تختبر بعض أدوات سطح المكتب الاتصال عن طريق طلب اسم نموذج محدد من المزود الأصلي، وتُبلغ عن فشل حتى عندما تكون نقطة النهاية سليمة. في هذه الحالة، تخط زر الاختبار وأرسل رسالة حقيقية. إذا وصلت الإجابة، فإن عنوان URL والمفتاح والنموذج صحيحون، والأداة تكون صارمة فقط في فحصها.
يمكن أن تواجه الأدوات التي تعمل في المتصفح أيضًا قواعد الأصل المتقاطع، حيث يغادر الطلب الصفحة إلى مضيف مختلف. إذا فشلت أداة ويب في المتصفح ولكن نفس المكالمة تعمل في curl، قم بتشغيل الطلب من خادم صغير خاص بك بحيث يبقى المفتاح خارج الكود الخاص بالعميل، وهو التصميم الأكثر أمانًا في أي حال.
الأخطاء الشائعة وكيفية إصلاحها
يأتي كل إعداد فاشل تقريبًا من قائمة قصيرة.
- غياب /v1. عنوان URL الأساسي هو
https://api.uncensoredgptapi.com/v1، وهو العنوان الكامل حتى/v1وليس اسم المضيف فقط. بدون/v1، يبني الـ SDK مسارات غير موجودة. - مسار مكرر. إذا لصقت
.../v1/chat/completionsكعنوان URL أساسي، سيضيف الـ SDK المسار مرة أخرى. أعطه الأساس فقط. - شرطة مائلة في النهاية. تتعامل معظم الـ SDKs معها، لكن بعض الأدوات لا تفعل. جرب بدونها.
- اسم نموذج قديم. لن يتطابق اسم نموذج مثل
gpt-4oالمتبقي من الكود الأصلي. اضبطuncensored. - مفتاح خاطئ. استخدم المفتاح من هذه الخدمة. لا يعمل مفتاح OpenAI هنا، ولا يعمل مفتاحنا على OpenAI.
- أخطاء حدّ المعدل. تعني HTTP 429 مع الرمز
rate_limitedإرسال طلبات كثيرة جدًا في الدقيقة؛ الرمزconcurrencyيعني إرسال طلبات كثيرة جدًا في وقت واحد. يشير الرد 429 مع رأسRetry-After: 5إلى حمل زائد مؤقت، لذا انتظر خمس ثوانٍ وأعد المحاولة.
يُعالج دليل استكشاف الأخطاء الخاص بنا أخطاء التكامل بتفصيل أكثر.
تحقق من الإعداد في مكالمة واحدة
قبل تشغيل تطبيقك بالكامل، اتصل بنقطة النهاية الخاصة بالنماذج. إنها رخيصة وتؤكد صحة عنوان URL والمفتاح معًا.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"إذا أرجعت هذه القائمة التي تحتوي على uncensored، أرسل طلب دردشة حقيقي. بالنسبة للمفتاح الكامل، يمكنك توقع ما يصل إلى 8 طلبات متزامنة و300 طلب في الدقيقة؛ يسمح المفتاح التجريبي بـ 2 طلب متزامن و60 في الدقيقة. يتضمن كل رد X-Request-Id، X-Balance-USD ورؤوس حدّ المعدل، وهي مفيدة عند تصحيح الأخطاء.
للحصول على مفتاح، أنشئ حساباً واستخدم صفحة مفتاح API، حيث يمكن للمستخدمين الجدد المطالبة برصيد تجريبي بقيمة $0.50 بنقرة واحدة. يغطي الوثائق البث المتدفق، استدعاء الدوال ووضع JSON بمجرد أن يعمل الاتصال.
