Compare LLM APIالمستندات
بداية سريعة لواجهة برمجة تطبيقات LLM: نقاط نهاية متوافقة مع OpenAI
ابدأ في توليد النصوص باستخدام واجهة برمجة تطبيقات LLM غير الخاضعة للرقابة في دقائق. يغطي هذا الدليل السريع نقاط النهاية المتوافقة مع OpenAI، وإعداد SDK، وخيارات البث المتدفق التي تحتاجها لدمج مخرجات النموذج الخام في تطبيقك.
المصادقة وعنوان URL الأساسي
لبدء استخدام خدمات مزود LLM API، تحتاج إلى مفتاح API. سجّل في صفحة الحصول على مفتاح API باستخدام البريد الإلكتروني وكلمة المرور فقط. يظهر مفتاحك فوراً. لا يتطلب الرصيد التجريبي المجاني رقم هاتف أو بطاقة ائتمان. احفظ مفتاحك بأمان؛ يمكنك تجديده في أي وقت، مما يلغي صلاحية المفتاح السابق.
قم بتكوين عميلك للإشارة إلى عنوان URL الأساسي الخاص بنا. يضمن ذلك توجيه جميع الطلبات إلى نموذجنا غير الخاضع للرقابة. يعكس هيكل نقطة النهاية واجهة إكمال المحادثات القياسية الخاصة بـ OpenAI.
- عنوان URL الأساسي:
https://api.comparellmapi.com/v1 - رأس الطلب:
Authorization: Bearer YOUR_API_KEY
يعمل هذا الإعداد مع أي مكتلة متوافقة مع OpenAI. تحتاج فقط إلى تعديل عنوان URL الأساسي وإدراج مفتاحك.
طلبك الأول
أرسل طلب إكمال نصي بسيط لاختبار الاتصال. يؤكد هذا أن مفتاح API الخاص بك صالح وأن الرصيد متاح. استخدم معرف النموذج uncensored للوصول إلى النموذج الخام. تقبل نقطة النهاية طلبات POST مع جسم JSON يحتوي على الرسائل.
تأكد من أن جسم الطلب لا يتجاوز 8 ميجابايت. إذا تجاوزت هذا الحد، سيرفض الخادم الطلب. بالنسبة لمعظم التطبيقات القائمة على النصوص، يتسع دور واحد أو محادثة قصيرة بسهولة ضمن هذا القيد.
curl https://api.comparellmapi.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."}]
}'إذا نجحت العملية، تتلقى استجابة JSON تحتوي النص المولّد. يؤكد هذا أن هيكل llm api pricing ينطبق على استخدامك. كل رمز يُحتسب من رصيدك المسبق.
تكامل مكتبة Python SDK
استخدم مكتبة Python الرسمية الخاصة بـ OpenAI لأسهل تكامل. قم بتثبيت الحزمة عبر pip، ثم قم بتكوين العميل مع عنوان URL الأساسي الخاص بنا. يتيح لك ذلك استخدام الأساليب المألوفة مثل chat.completions.create().
حدد النموذج إلى uncensored. مرر رسائلك بالتنسيق القياسي. تتعامل المكتبة مع التسلسل وتحليل الأخطاء تلقائياً.
from openai import OpenAI
client = OpenAI(base_url="https://api.comparellmapi.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)هذا النهج مثالي لخدمات الخلفية أو البرامج النصية. تدير المكتبة عمليات إعادة المحاولة ومعالجة الأخطاء الأساسية. تذكر التحقق من محتوى الاستجابة للحصول على النص المولد. يمكنك أيضاً الوصول إلى بيانات استخدام الرموز للشفافية في الفواتير.
إعداد مكتبة Node.js SDK
لبيئات JavaScript أو TypeScript، تعمل مكتبة Node.js الخاصة بـ OpenAI بسلاسة. قم بتثبيت الحزمة وتهيئة العميل مع عنوان URL الأساسي الخاص بنا. يحافظ هذا على التوافق مع واجهة API القياسية.
عرّف رسائل النظام والمستخدم. يبقى معرف النموذج uncensored. تُرجع المكتبة وعداً بنتيجة الاكتمال. تعامل مع الأخطاء بشكل مناسب لإدارة حدود واجهة برمجة التطبيقات أو عدم كفاية الرصيد.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.comparellmapi.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);هذه الطريقة مناسبة لخوادم الويب أو تطبيقات Node.js. يعكس هيكل الكود مثال Python، مما يضمن الاتساق عبر اللغات. يمكنك دمج هذا في مسارات Express أو الوظائف الخالية من الخوادم بسهولة.
استجابات البث المتدفق (SSE)
لتطبيقات الوقت الحقيقي، فعّل البث المتدفق عن طريق تعيين المعلمة stream إلى true. يرسل الخادم سلسلة من أحداث Server-Sent Events (SSE). يحتوي كل حدث على جزء جزئي من الاستجابة.
يقلل هذا من زمن الاستجابة المدرك للمستخدمين. يتلقى العميل الرموز بمجرد توليدها. يعد هذا مفيداً لواجهات الدردشة أو توليد النص المباشر.
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)قم بتحليل تدفق SSE لاستخراج كل رمز. اجمع النص لتشكيل الاستجابة الكاملة. تكلفة تكلفة واجهة برمجة تطبيقات chatgpt ومقدمي الخدمات الآخرين غالباً ما تكون متشابهة في البث المتدفق، لكن نموذجنا بدون رقابة يوفر إخراجاً خاماً دون رسوم إضافية لهذا الوضع. راقب حدث نهاية التدفق لإنهاء الاستجابة.
الحدود والأخطاء والسياق
فهم الحدود التشغيلية لضمان تكامل سلس. يُسمح لك بـ 300 طلب في الدقيقة لكل مفتاح API. إذا تجاوزت هذا، ستتلقى خطأ حد المعدل 429. انتظر قبل إعادة المحاولة.
تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة و402 لعدم كفاية الرصيد. تأكد من أن رصيدك المسبق الدفع كافٍ. تدعم نافذة السياق ما يصل إلى 100,000 رمز للموجّه بالإضافة إلى الإكمال. أدر استخدام الرموز بعناية لتجنب الاقتصاص.
للحصول على تفاصيل أسعار LLM API، يرجى الرجوع إلى صفحة الأسعار. يتم احتساب كل رمز وفقاً لمعدلات الإدخال والإخراج. لا توجد رسوم خفية. يساعدك هذا الشفافية في وضع ميزانية دقيقة لتطبيقك.
مواصفات API
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.comparellmapi.com/v1 |
| معرّف النموذج | uncensored |
| المصادقة | Authorization: Bearer YOUR_KEY |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| وضع JSON | response_format: {"type": "json_object"} |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| مكافأة | +5% من $50، +10% من $100 |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| تسجيل الدخول | 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 الخاص بي؟
يمكنك إعادة إنشاء مفتاح API الخاص بك في أي وقت من لوحة تحكم حسابك. يؤدي إنشاء مفتاح جديد إلى إلغاء سريان المفتاح القديم على الفور، لذا قم بتحديث تطبيقاتك لاستخدام المفتاح الجديد. يعد هذا مفيدًا إذا كنت تشك في تعرض المفتاح للاختراق.
ماذا يحدث إذا نفد رصيدك؟
عندما يصل رصيدك المسبق الدفع إلى الصفر، ستتلقى خطأ 402 في الطلبات اللاحقة. يمكنك شحن الرصيد من 10 دولار باستخدام العملات المشفرة (USDT أو USDC). تُضاف رصيداً إضافياً تلقائياً للشحنات الأكبر بقيمة 50 أو 100 دولار.
هل النموذج غير الخاضع للرقابة مناسب للاستخدام التجاري؟
نعم، تم تصميم النموذج لحالات الاستخدام القانونية للبالغين والإبداعية دون رفض المحتوى. وهو غير مناسب للمحتوى الذي يتضمن قاصرين. النموذج مفتوح الأوزان ويعمل على خوادمنا الخاصة، مما يوفر مخرجات نصية خام لتطبيقاتك.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.