Best LLM API التوثيق
دليل البدء السريع: التكامل المباشر
دمج LLM API بدون رقابة في تطبيقك من خلال استبدال عنوان URL الأساسي ومفتاح API في قاعدة الشيفرة المتوافقة مع OpenAI الحالية.
المتطلبات المسبقة
قبل إرسال طلبك الأول، تأكد من امتلاكك لمفتاح API صالح. سجّل في صفحة الحصول على مفتاح API لتلقي مفتاحك على الفور. لا حاجة لبطاقة ائتمان للتجربة الأولية. ستحتاج إلى بيئة لغة برمجة مدعومة (Python 3.8+ أو Node.js 18+) وـ SDK الرسمي لـ OpenAI مثبتًا في مشروعك.
تعمل خدمتنا كبديل جاهز للاستخدام لنقاط النهاية القياسية لإكمال الدردشة. لا تحتاج إلى تثبيت مكتبة عميل مخصصة؛ يتعامل الـ SDK القياسي لـ OpenAI مع بروتوكول الاتصال، بما في ذلك البث المتدفق واستدعاء الأدوات، بشرط تكوين عنوان URL الأساسي بشكل صحيح.
المصادقة
يتم التعامل مع المصادقة عبر رأس Authorization. مرّر مفتاح API الخاص بك كرمز Bearer. إذا كان المفتاح غير صالح أو منتهي الصلاحية، تُعيد الـ API خطأ 401 Unauthorized. إذا كان رصيد حسابك غير كافٍ، تتلقى خطأ 402 Payment Required. أضف مفتاحك إلى متغيرات البيئة أو ملف التكوين لتجنب تثبيت البيانات الاعتمادية في الكود.
- رأس:
Authorization: Bearer YOUR_API_KEY - عنوان URL الأساسي:
https://api.bestllmapi.com/v1
احتفظ بمفتاحك آمنًا. يمكنك تجديده في أي وقت من لوحة التحكم، مما يلغي صلاحية المفتاح السابق على الفور.
إكمال الدردشة الأساسي
أرسل طلب POST إلى /v1/chat/completions مع معرف model بقيمة uncensored وسجل رسائلك. يعيد الـ API استجابة نصية. تدعم نقطة النهاية هذه هياكل JSON القياسية الخاصة بـ OpenAI، مما يجعل الترحيل من مقدّمي الخدمات الآخرين أمرًا مباشرًا.
تأكد من هيكلة رسائلك بشكل صحيح مع أدوار مثل system، وuser، وassistant. يعالج النموذج الإدخال ويولد إكمالًا بناءً على سياق الموجّه الخاص بك.
curl https://api.bestllmapi.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 في جسم الطلب. يعيد الـ API دفق أحداث مرسلة من الخادم (SSE) يحتوي على كائنات delta. يحتوي كل delta على جزء من النص المُولّد. معالجة هذه القطع بشكل متزايد لعرض النص أثناء توليده، مما يقلل من زمن الاستجابة المدرك للمستخدمين النهائيين.
معالجة التدفق متطابقة مع بروتوكول التدفق القياسي لـ OpenAI. يجب عليك معالجة حدث إكمال التدفق لمعرفة متى ينتهي التوليد.
from openai import OpenAI
client = OpenAI(base_url="https://api.bestllmapi.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)
استدعاء الدوال
عرّف الدوال في جسم الطلب الخاص بك باستخدام المعلمة tools. قد يُعيد النموذج كائن استدعاء دالة بدلاً من نص مباشر. قم بتحليل اسم الدوال والحجج، ونفّذ الدوال في الكود الخاص بك، ثم أرسل النتائج مرة أخرى إلى النموذج للحصول على الاستجابة النهائية. يتيح هذا لـ LLM الخاص بك التفاعل مع الـ APIs أو قواعد البيانات الخارجية بشكل ديناميكي.
يتبع استدعاء الدوال المخطط القياسي لـ OpenAI. تأكد من أن تعريفات الدوال دقيقة لتحسين دقة النموذج في اختيار الأداة الصحيحة واستخراج الحجج.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.bestllmapi.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);
حدود نافذة السياق
يدعم النموذج نافذة سياق بحجم 100,000 رمز، مما يجمع بين رموز الموجّه ورموز الإكمال. راقب استخدام الرموز لتجنب تجاوز هذا الحد، مما يؤدي إلى خطأ 400 Bad Request. إذا وصلت إلى حدّ المعدل البالغ 300 طلب في الدقيقة، تتلقى خطأ 429 Too Many Requests.
نفّذ زيادة عكسية أُسّية لإعادة المحاكمة. محدودية أحجام الطلبات هي 8 MB. للمحادثات الطويلة، فكر في تلخيص الرسائل السابقة للبقاء ضمن ميزانية الرموز مع الحفاظ على السياق.
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)المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| المصادقة | Authorization: Bearer YOUR_KEY |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.bestllmapi.com/v1 |
| معرّف النموذج | uncensored |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| وضع JSON | response_format: {"type": "json_object"} |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| مكافأة | +5% من $50، +10% من $100، +15% من $200 |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $20 إلى $500 |
| السعر | $0.15 لكل مليون رمز مدخلات · $0.50 لكل مليون رمز مخرجات |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| تسجيل الدخول | 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 | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
هل يتوافق هذا الـ API مع الـ SDK الرسمي لـ OpenAI؟
نعم، هو متوافق تمامًا. تحتاج فقط إلى تغيير عنوان URL الأساسي ومفتاح API في تكوين الـ SDK الحالي الخاص بـ OpenAI لاستخدام هذه الخدمة.
ماذا يحدث إذا تجاوزت حدّ المعدل؟
يعيد الـ API خطأ 429 Too Many Requests. يجب عليك تنفيذ منطق إعادة المحاكمة مع زيادة عكسية أُسّية للتعامل مع هذا بشكل سلس.
هل يمكنني استخدام هذا الـ API لتوليد الصور؟
لا، يقدم هذا الـ API إكمال النصوص فقط. لا يدعم نقاط النهاية لتوليد الصور أو الصوت أو الفيديو.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.