نقاط نهاية API المتوافقة مع OpenAI: ما الذي يدعمه
قائمة بنقاط نهاية واجهة API المتوافقة مع OpenAI التي تدعمها هذه الخدمة، مع طلبات عاملة لكل منها وقائمة واضحة لما ينقص.
نقاط رئيسية
- خمسة مسارات: إكمال الدردشة، الاستجابات، النماذج وطريقي رصيد.
- معرف النموذج هو uncensored، ومفتاح واحد يعمل مع أي SDK لـ OpenAI.
- لا صور، صوت، فيديو، تضمين أو ضبط دقيق.
- تُعيد الحدود HTTP 429 مع رمز خطأ واضح.

نظرة عامة على نقاط النهاية
أي مسارات على طراز OpenAI تنفّذها المزوّد حقاً؟ إليك القائمة المختصرة لهذه واجهة API. عنوان URL الأساسي: https://api.uncensoredendpoint.com/v1. المصادقة مفتاح حامل في كل استدعاء.
| الطريقة والمسار | الغرض |
|---|---|
POST /v1/chat/completions | طلبات الدردشة، البث المتدفق، الأدوات، وضع JSON |
POST /v1/responses | صيغة الطلب الأحدث على نمط Responses |
GET /v1/models | يُدرج النموذج؛ والمعرّف هو uncensored |
GET /v1/dashboard/billing/credit_grants | الرصيد بصيغة مطابقة لـ OpenAI |
GET /v1/balance | الرصيد بصيغة بسيطة |
هذا هو السطح الكامل. أي شيء غير موجود في الجدول غير مُقدّم. تابع القراءة للاطلاع على الطلبات العاملة وقائمة ما ينقص، حتى تخطط لذلك قبل كتابة الكود.
إكمالات الدردشة
هذه هي نقطة النهاية التي تستخدمها معظم العملاء. وجّه أي SDK من OpenAI إلى عنوان الأساس واستخدم اسم النموذج uncensored.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "List three uses of a webhook."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)تشمل المعاملات المدعومة stream، tools، tool_choice، response_format مع json_object، ومجموعة أخذ العينات: temperature، top_p، stop، seed والخصومات. max_tokens اختيارية، لأن الإكمال يمكن أن يستخدم أي شيء متبقي من نافذة الـ 100,000 رمز.
مع stream: true تصل الاستجابة كحدث مرسَل من الخادم ويُدرج الاستخدام في النهاية، بحيث يمكنك تسجيل عدد الرموز.
محادثات متعددة الأدوار
لا تحتفظ واجهة API بحالة المحادثة. للمحادثة متعددة الأدوار، أرسل قائمة الرسائل الكاملة في كل مرة: رسالة النظام أولاً، ثم تناوب أدوار المستخدم والمساعد. هذا يعني أن رموز المدخلات تزداد مع كل دور، وتزداد التكلفة أيضاً، لذا قم بتقليص أو تلخيص الأدوار القديمة بمجرد طول المحادثة. النافذة هي 100,000 رمز للموجّه بالإضافة إلى الإكمال، وهو الكثير لمعظم المحادثات لكنه يمتلئ بسهولة مع المستندات المنسوخة.
الاستجابات، النماذج والرصيد
الاستجابات
تستخدم أمثلة OpenAI الأحدث المسار /v1/responses. وهو متاح هنا أيضاً، لذا لا حاجة لإعادة كتابة الكود المكتوب لتلك الصيغة.
curl https://api.uncensoredendpoint.com/v1/responses \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "input": "Write a haiku about caching."}'استخدم ما يتوقعه عميلك. إذا كنت تبدأ من الصفر، فإن إكمال الدردشة يوفر أوسع دعم للأدوات.
النماذج والرصيد
أدرج النماذج للتحقق من أن مفتاحك يعمل. يجب أن ترى إدخالاً واحداً فقط، وهو uncensored، لأن الخدمة تشغل نموذجاً واحداً وليست موجهاً عبر موردين.
curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"
# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"
# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"تحصل أيضاً على الرصيد في كل استجابة عبر رأس X-Balance-USD، وهو مفيد لتنبيه انخفاض الرصيد في تطبيقك دون طلب إضافي. تشمل الرؤوس الأخرى X-Request-Id لأسئلة الدعم، بالإضافة إلى X-RateLimit-Limit-Requests و X-RateLimit-Limit-Concurrency.
الأدوات ووضع JSON في الممارسة العملية
يحوّل ميزتان نقطة نهاية المحادثة إلى شيء يمكنك بناء منتج عليه. استدعاء الدوال يسمح للنموذج بطلب تشغيل دالة في كودك. وضع JSON يجعله يُرجع ناتجاً قابلاً للتحليل. كلاهما يستخدم حقول الطلب القياسية.
يبدو استدعاء الأداة هكذا. يُرجّع النموذج إدخالاً من نوع tool_calls، وتشغّل الدالة، ثم ترسل النتيجة مرة أخرى كرسالة مع role: "tool".
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)
msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)لوضع JSON، أضف response_format={"type": "json_object"} واذكر في الموجّه أنك تريد JSON، ويفضّل أن تتضمن المفاتيح المتوقعة. قم دائمًا بتحليل النتيجة داخل كتلة try: لا يضمن النموذج مخطط البيانات في كل استدعاء، لذا تحقق من صحة النتيجة قبل الاعتماد عليها.
نقل مشروع OpenAI الحالي
إذا كان تطبيقك يستخدم بالفعل SDK الخاص بـ OpenAI، فإن الترحيل يتطلب ثلاثة تعديلات فقط ولا يحتاج إلى مكتبة جديدة. تقرأ معظم مكتبات SDK متغيري البيئة نفسه، لذا يمكنك غالبًا عدم تغيير أي شيء في الكود على الإطلاق.
export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEYimport OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);ثم ابحث في الكود عن أسماء النماذج مثل معرف نموذج GPT واستبدلها بـ uncensored، لأن الخدمة تستخدم نموذجاً واحداً. أزل استدعاءات التضمين والصور أو الصوت، ووجّهها إلى مزوّد آخر. احتفظ بقائمة مراجعة مختصرة: تغيير عنوان URL الأساسي، تغيير اسم النموذج، تخزين المفتاح في متغير بيئة وليس في المستودع، منطق إعادة المحاولة لـ 429، وتنبيه انخفاض الرصيد بناءً على رأس الرصيد. لإعداد المفتاح، انظر كيفية الحصول على مفتاح واجهة API للذكاء الاصطناعي بدون رقابة. ثم نفذ طلب اختبار واحد وتأكد من عودة X-Balance-USD، قبل تحويل حركة المرور الحقيقية.
ما لا يتم تقديمه
معرفة الفجوات توفر يومًا من تصحيح الأخطاء. هذه الخدمة للنصوص فقط. نقاط النهاية التالية الخاصة بـ OpenAI غير متاحة:
- توليد الصور والرؤية. لا يوجد توليد صور أو تعديل.
- الصوت. لا يوجد تحويل من صوت إلى نص أو من نص إلى صوت.
- الفيديو. غير مُقدَّم.
- التضمين. إذا كنت تبني الاسترجاع، تحتاج إلى خدمة تضمين منفصلة.
- التدريب. لا يمكنك التدريب على الخدمة.
ستفشل الطلبات الموجهة إلى هذه المسارات، لذا تجنب تضمينها في أي إعداد مشترك للعميل. يضبط الإعداد النموذجي هذه الخدمة للمحادثة مع مزوّد آخر للتضمين، ويختار تطبيقك عنوان URL الأساسي حسب المهمة.
الحدود والأخطاء وإعادة المحاولة
المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح المفتاح التجريبي بـ 2 طلب متزامن و60 طلب في الدقيقة. الحد الأقصى لحجم الجسم هو 8 MB. عند تجاوز حد، ستحصل على خطأ HTTP 429 مع رمز خطأ يوضح أي حد تم تجاوزه: rate_limited لطلبات في الدقيقة، وconcurrency لعدد الطلبات المتزامنة الزائد. في حالات الحمل المؤقت، ستحصل أيضًا على خطأ 429 مع رأس Retry-After: 5.
تفاصيل واحدة قد تفاجئك: يحمل الطلب المتدفق (streamed) مقعد التزامن حتى انتهاء البث، لذا فإن القراء البطيئين يحسبون ضمن الحد. يمكن لمغلف إعادة المحاولة البسيط التعامل مع كل هذا:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
def ask(prompt, tries=4):
for i in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (i + 1))
raise RuntimeError("still rate limited")الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا لا تكلف إعادة المحاولة في الأخطاء أي رسوم إضافية. للأعمال الدفعية، حدّ من مجموعة عمالك إلى 8 على مفتاح كامل، أو 2 على مفتاح تجريبي، بدلاً من الاعتماد على إعادة المحاولة. المجموعة الثابتة أسهل في الفهم، وهي تمنع تدفقاً بطيئاً من حرمان الآخرين.
التكلفة والوصول
التسعير هو $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز ناتج، من رصيد مسبق الدفع بدون اشتراك وبدون انتهاء. قم بشحن الرصيد بمبلغ كامل من $20 إلى $500، عبر العملات المشفرة فقط (USDT على TRC20، USDC على Base). تزيد الشحنات الأكبر من المكافأة: +5% من $50، +10% من $100، +15% من $200. انظر صفحة التسعير.
للتجربة، سجّل باستخدام Google أو البريد الإلكتروني، ثم احصل على رصيد تجريبي مجاني بقيمة $0.50 بنقرة واحدة على صفحة مفتاح API. تغطي الوثائق كل معامل، ويشرح نظرة عامة على نقاط النهاية ما هي الخدمة: نموذج مفتوح الأوزان للاستخدام القانوني للبالغين، بدون رفض محتوى وحظر صارم للمحتوى الجنسي الذي يتضمن القاصرين.
المزيد من الأدلة
أسئلة وأجوبة
هل يدعم البث المتدفق واستدعاء الدوال؟
نعم. استخدم stream: true لأحداث Server-Sent Events مع الاستخدام في النهاية، وأدوات مع tool_choice لاستدعاء الدوال.
هل توجد نقطة نهاية للتضمين؟
لا. الخدمة تقتصر على محادثة النصوص فقط، لذا استخدم مزوّدًا آخر للتضمين.
كيف أتحقق من رصيدي؟
استدعِ GET /v1/balance أو مسار credit_grants على طراز OpenAI، أو اقرأ رأس X-Balance-USD في أي استجابة.
ماذا يحدث عند بلوغ حدّ المعدل؟
ستحصل على خطأ HTTP 429 مع الرمز rate_limited أو concurrency. انتظر وأعد المحاولة؛ في حالة الحمل الزائد المؤقت، يشير رأس Retry-After إلى 5 ثوانٍ.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.