AR ▾

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 URLhttps://api.comparellmapi.com/v1
معرّف النموذجuncensored
المصادقةAuthorization: Bearer YOUR_KEY
نافذة السياق100,000 رمز (المدخلات والمخرجات معاً)
وضع JSONresponse_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 ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.

الرمزالنوعالمعنى
400bad_requestJSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق
401missing_key · invalid_key · key_revokedلا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله
402no_creditالرصيد فارغ — اشحن وتستأنف الطلبات فوراً
403content_blockedمحتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب
404not_foundنقطة نهاية غير معروفة
413request_too_largeجسم الطلب أكبر من 8 MB
429rate_limited · concurrencyتجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة
503upstream_busyالنموذج مشغول — أعد المحاولة بعد ثوانٍ

أسئلة وأجوبة

كيف يمكنني إعادة تعيين مفتاح API الخاص بي؟

يمكنك إعادة إنشاء مفتاح API الخاص بك في أي وقت من لوحة تحكم حسابك. يؤدي إنشاء مفتاح جديد إلى إلغاء سريان المفتاح القديم على الفور، لذا قم بتحديث تطبيقاتك لاستخدام المفتاح الجديد. يعد هذا مفيدًا إذا كنت تشك في تعرض المفتاح للاختراق.

ماذا يحدث إذا نفد رصيدك؟

عندما يصل رصيدك المسبق الدفع إلى الصفر، ستتلقى خطأ 402 في الطلبات اللاحقة. يمكنك شحن الرصيد من 10 دولار باستخدام العملات المشفرة (USDT أو USDC). تُضاف رصيداً إضافياً تلقائياً للشحنات الأكبر بقيمة 50 أو 100 دولار.

هل النموذج غير الخاضع للرقابة مناسب للاستخدام التجاري؟

نعم، تم تصميم النموذج لحالات الاستخدام القانونية للبالغين والإبداعية دون رفض المحتوى. وهو غير مناسب للمحتوى الذي يتضمن قاصرين. النموذج مفتوح الأوزان ويعمل على خوادمنا الخاصة، مما يوفر مخرجات نصية خام لتطبيقاتك.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.

احصل على مفتاح API