دليل البدء السريع لواجهة برمجة التطبيقات للذكاء اللغوي غير الخاضع للرقابة
يساعدك دليل البدء السريع هذا في دمج واجهة برمجة التطبيقات الخاصة بالمحادثات غير الخاضعة للرقابة باستخدام عملاء متوافقين مع OpenAI القياسي. ستجد عنوان URL الأساسي، خطوات المصادقة، أمثلة التعليمات البرمجية، والحدود اللازمة لبدء إرسال الطلبات فوراً.
المصادقة والرؤوس
تستخدم واجهة برمجة التطبيقات الخاصة بنا مصادقة مفتاح API القياسية. يجب عليك تضمين مفتاحك في رأس Authorization لكل طلب. تحصل الحسابات الجديدة على مفتاح فوراً بعد التسجيل في صفحة الحصول على مفتاح API. إذا فقدت مفتاحك، يمكنك إعادة إنشائه في أي وقت، مما يلغي المفتاح القديم. يُسمح بمفتاح نشط واحد فقط لكل حساب.
عنوان URL الأساسي لجميع الطلبات هو https://api.llmapistatus.com/v1. يعمل هذا مع حزم SDK الرسمية لـ OpenAI وأي عميل متوافق مع OpenAI من خلال تحديث تكوين base_url فقط. لا توجد رؤوس خاصة مطلوبة بخلاف المصادقة.
نقطة النهاية لإكمال المحادثات
أرسل نصاً واحصل على نص باستخدام نقطة النهاية POST /v1/chat/completions. معرف النموذج هو دائماً uncensored. هذا نموذج مفتوح الأوزان يعمل على خوادم GPU الخاصة بنا، ومُضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. إنه ليس GPT أو Claude أو أي نموذج من مزود آخر.
تدعم واجهة برمجة التطبيقات استدعاء الأدوات والدوال. لا تحتاج إلى إدارة التوجيه بين البائعين المختلفين؛ نحن نقدم نقطة نهاية مخصصة واحدة وغير خاضعة للرقابة. للمقارنات العامة لمقدمي الخدمات الآخرين، انظر لوحة قيادة LLM الخاصة بنا.
curl https://api.llmapistatus.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
استجابات البث المتدفق
لتقليل زمن الوصول، يمكنك تمكين البث المتدفق عن طريق تعيين stream: true في جسم الطلب الخاص بك. تعيد واجهة برمجة التطبيقات تدفق أحداث المخدم (SSE). هذا مثالي لواجهات الدردشة حيث تريد عرض الرموز بمجرد إنشائها.
يعمل البث المتدفق مع حزم SDK الرسمية لـ OpenAI وعملاء HTTP العامة. يستمر التدفق حتى ينتهي النموذج أو يحدث خطأ. تقلل هذه الطريقة من وقت الانتظار المدرك للمستخدمين، مما يجعل النموذج غير الخاضع للرقابة يبدو أكثر استجابة في تطبيقات الإنتاج.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
دعم استدعاء الدوال
تدعم واجهة برمجة التطبيقات المخرجات المهيكلة عبر استدعاء الدوال. يمكنك تعريف الأدوات في طلبك وسيعيد النموذج JSON مهيكلاً يتطابق مع مخططك. هذا مفيد لبناء الوكلاء أو التطبيقات التي تحتاج إلى التفاعل مع الأنظمة الأخرى.
استخدم المعلمة tools في طلب إكمال المحادثة الخاص بك. سيعود النموذج باستدعاءات الأدوات عند الاقتضاء، مما يسمح لك بتنفيذ الدوال وإرجاع النتائج إلى المحادثة. هذه الميزة متاحة في جميع الطلبات دون تكلفة إضافية.
from openai import OpenAI
client = OpenAI(base_url="https://api.llmapistatus.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
عرض النموذج ونافذة السياق
يمكنك سرد النماذج المتاحة باستخدام نقطة النهاية GET /v1/models. سيعيد هذا البيانات الوصفية بما في ذلك معرف النموذج، وهو uncensored. يدعم النموذج نافذة سياق من 100,000 رمز لكل من الموجّه والإكمال معاً.
تسمح لك نافذة السياق الكبيرة بنقل تعليمات النظام الشاملة، وسجل المحادثة، أو محتوى المستند في طلب واحد. إنها مناسبة للتوليد طويل المدى أو معالجة المستندات الكبيرة. احتفظ بإجمالي عدد الرموز ضمن حد 100k لتجنب الأخطاء.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.llmapistatus.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
حدود المعدل والحصص
يتم تحديد كل مفتاح API بـ 300 طلب في الدقيقة. حجم جسم الطلب الأقصى هو 8 ميجابايت. إذا تجاوزت حدّ المعدل، ستتلقى رمز الحالة 429. إذا كان مفتاح API الخاص بك غير صالح، فستحصل على خطأ 401. إذا لم يكن لديك رصيد مسبق الدفع، فستتلقى خطأ 402.
الأسعار شفافة: $0.25 لكل مليون رمز مدخل و $1.00 لكل مليون رمز مخرج. الرصيد مسبق الدفع ولا ينتهي. يمكنك شحن الرصيد من $10 عبر العملات المشفرة (USDT أو USDC). راجع صفحة أسعار LLM API للحصول على تفاصيل حول الرصيد الإضافي.
المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| المصادقة | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.llmapistatus.com/v1 |
| وضع JSON | response_format: {"type": "json_object"} |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| مكافأة | +5% من $50، +10% من $100 |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
هل هذا النموذج هو نفسه GPT-4 أو Claude؟
لا. معرف النموذج هو "uncensored" وهو نموذج مفتوح الأوزان يعمل على خوادم GPU الخاصة بنا. تم ضبطه للاستخدام القانوني للبالغين دون رفض المحتوى، لكنه نموذج مميز عن GPT وClaude وGemini أو البائعين الآخرين.
كيف أبدأ باستخدام الرصيد التجريبي؟
سجّل في صفحة الحصول على مفتاح API باستخدام البريد الإلكتروني وكلمة المرور فقط. ستتلقى $0.50 من رصيد تجريبي صالح لمدة 7 أيام. لا يلزم بطاقة ائتمان أو رقم هاتف للبدء.
ماذا يحدث إذا تجاوزت حدّ المعدل؟
إذا تجاوزت 300 طلب في الدقيقة، سيعيد الواجهة برمجة التطبيقات رمز الحالة 429. يجب عليك تنفيذ استرجاع أسي في العميل الخاص بك. يمكنك إعادة إنشاء مفتاحك إذا لزم الأمر، لكن حدّ المعدل ينطبق على كل مفتاح.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.