المتطلبات المسبقة
لاستخدام API الخاص بـ apertus، تحتاج إلى حساب ومفتاح API. سجّل عبر Google أو البريد الإلكتروني في صفحة الحصول على مفتاح API. تتلقى المفتاح فوراً؛ لا حاجة لرقم الهاتف. إذا أردت الاختبار أولاً، يحصل كل حساب جديد على $0.50 كرصيد تجريبي صالح لمدة 7 أيام. لا حاجة لبطاقة للاختبار. للإنتاج، اشحن بالعملات المشفرة (USDT على TRC20 أو USDC على Base). الرصيد لا ينتهي، والأخطاء لا تستهلك الرصيد. لديك مفتاح نشط واحد لكل حساب؛ استبدال المفتاح القديم عند إنشاء مفتاح جديد. احفظ مفتاحك بأمان وأمرره في رأس Authorization كرمز حامل. الـ API نصي بحت، يخدم نموذجاً واحداً بدون رقابة محسّن للإجابة دون رفض المحتوى.
عنوان URL الأساسي والمصادقة
وجّه جميع الطلبات إلى https://api.apertus.cc/v1. يعمل عنوان URL الأساسي هذا مع أدوات SDK الرسمية الخاصة بـ OpenAI وأي عميل متوافق عن طريق تغيير نقطة النهاية فقط. قم بتضمين مفتاح API الخاص بك في الرأس: Authorization: Bearer YOUR_API_KEY. نقطة النهاية المدعومة الوحيدة هي POST /v1/chat/completions. تتوفر أيضًا نقطة نهاية GET /v1/models للتحقق من الاتصال. معرف النموذج الذي يجب استخدامه هو uncensored. هذا نموذج مفتوح الأوزان يعمل على خوادمنا، وهو مختلف عن GPT أو Claude أو المزودين الآخرين. يتعامل مع مدخلات النص ويعيد إخراج النص. لا تتوقع تضمينات أو صورًا أو صوتًا. تم تصميم واجهة برمجة التطبيقات للمطورين الذين يريدون دمجًا مباشرًا دون تعقيدات توجيه النموذج.
الطلب الأول
أرسل طلب إكمال أساسي للتحقق من إعدادك. استخدم أمر curl لإرسال طلب POST إلى نقطة نهاية إكمال المحادثات. اضبط النموذج على uncensored وضمن رسالة بسيطة. يؤكد ذلك أن مفتاح API الخاص بك يعمل وأن عنوان URL الأساسي صحيح. يمكنك تعديل المعلمات مثل temperature أو max_tokens حسب الحاجة. سيحتوي الاستجابة على إخراج نص النموذج. إذا تلقيت خطأ 401، فافحص مفتاحك. يشير خطأ 402 إلى عدم كفاية الرصيد. يعني خطأ 429 أنك تجاوزت حدّ المعدل. يوضح هذا الطلب البسيط الوصول الخام إلى واجهة برمجة التطبيقات دون أي وسيط. إنها أسرع طريقة للتحقق من صحة الدمج الخاص بك قبل بناء منطق أكثر تعقيدًا.
دمج Python
استخدم مكتبة Python الرسمية openai للتفاعل مع واجهة برمجة التطبيقات. قم بتهيئة العميل بعنوان URL الأساسي https://api.apertus.cc/v1 ومفتاح API الخاص بك. اضبط النموذج على uncensored. أرسل الرسائل كقائمة من القواميس. تتعامل مكتبة SDK مع التسلسل وخطأ التحليل تلقائيًا. هذا النهج مثالي لخدمات الخلفية أو سكريبتات معالجة البيانات. يمكنك بث الاستجابات أو الحصول على كتل كاملة. كود العميل مطابق لما ستستخدمه مع OpenAI، فقط مع عنوان URL الأساسي المختلف. يقلل هذا من الاحتكاك عند التبديل من مزودين آخرين. تأكد من أن لديك أحدث إصدار من مكتبة SDK لأفضل توافق. الدمج بسيط، ويتطلب فقط تغييرات تكوين في إعداد العميل الحالي.
دمج Node.js
لبيئات JavaScript أو TypeScript، استخدم حزمة npm openai. قم بتكوين العميل بنفس عنوان URL الأساسي والمفتاح كما في Python. اتصل بـ chat.completions.create() باستخدام نموذج uncensored. مرر رسائلك بالتنسيق القياسي. هذا يعمل جيدًا لوظائف الخادم الخالي أو خلفيات Node.js. تدير مكتبة SDK طلبات HTTP وتحليل الاستجابة. يمكنك معالجة الأخطاء بسلاسة عن طريق التحقق من حالة الاستجابة. يظل الكود قابلاً للنقل عبر خدمات مختلفة متوافقة مع OpenAI. هذا يجعل من السهل تبديل المزودين إذا لزم الأمر. يدعم دمج Node.js كلًا من الأنماط المتزامنة وغير المتزامنة. استخدمه لبناء واجهات برمجة التطبيقات أو الروبوتات أو سير العمل الآلي الذي يتطلب توليد نصوص بدون رقابة.
استجابات البث المتدفق
فعّل البث المتدفق بتعيين stream: true في طلبك. تُرجع الـ API أجزاء من النص كما يتم إنشاؤها. هذا يحسن زمن الاستجابة المُدرَك للاستجابات الطويلة. يحتوي كل جزء على جزء من الإكمال. يتضمن الجزء الأخير إحصائيات استخدام الرموز. البث المتدفق مدعوم عبر أحداث الإرسال من الخادم (SSE). استخدم مساعدي البث المتدفق في الـ SDK لمعالجة الأجزاء بكفاءة. هذا مفيد لواجهات الدردشة أو التطبيقات في الوقت الفعلي. لاحظ أن البث المتدفق يستهلك نفس الرموز مثل عدم البث. قد تحدث أخطاء أثناء البث، لذا تعامل مع الانقطاعات. يدعم النموذج بدون رقابة البث المتدفق افتراضياً. تتيح لك هذه الميزة عرض النص تدريجياً. إنها ميزة قياسية في APIs LLM الحديثة. تأكد من أن رمز العميل يتعامل مع الاستجابات الجزئية بشكل صحيح.
الحدود والأخطاء والنافذة السياقية
نافذة السياق هي 100,000 رمز إجمالاً، بما في ذلك الموجّه والإكمال. الحد الأقصى للإخراج هو 32,000 رمز لكل طلب، أو 2,048 إذا لم يتم تعيين max_tokens. حدود المعدل هي 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. يجب أن تكون أحجام الطلبات أقل من 8 MB. تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة، و402 لعدم وجود رصيد، و429 لحدود المعدل. يرفض النموذج المحتوى الجنسي الذي يتضمن قاصرين. لا يرفض مواضيع أخرى قانونية للبالغين، أو خيالية، أو جدلية. التسعير شفاف: $0.25 لكل مليون رمز إدخال و$1.00 لكل مليون رمز إخراج. الأخطاء مجانية. الرصيد مسبق الدفع ولا ينتهي. استخدم هذه الحدود لتخطيط نطاق تطبيقك. تم تصميم الـ API لتوليد النصوص عالي الحجم وفعال من حيث التكلفة.
cURL
curl https://api.apertus.cc/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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.apertus.cc/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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apertus.cc/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);البث المتدفق
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)