أول طلب في 5 دقائق

عنوان URL الأساسي والمصادقة

استخدم الـ API عبر عنوان URL الأساسي المخصص https://api.apertus.top/v1. الخدمة متوافقة مع OpenAI، مما يعني أنه يمكنك استخدام حزم SDK القياسية عن طريق تحديث base_url وتقديم مفتاح API الخاص بك. سجّل حسابك في صفحة الحصول على مفتاح API باستخدام حساب Google أو عنوان بريد إلكتروني. يظهر المفتاح فور إنشائه. يحتوي كل حساب على مفتاح نشط واحد؛ يؤدي إنشاء مفتاح جديد إلى استبدال المفتاح السابق. لا توجد اشتراكات شهرية أو تواريخ انتهاء للمفاتيح. الرصيد المسبق الدفع لا ينتهي، وتظل الأموال غير المستخدمة متاحة للطلبات المستقبلية. لا تستهلك الأخطاء والرفضات رصيدك.

أول طلب

أرسل طلب إكمال نصي بسيط لاختبار الاتصال والفوترة. استخدم معرف النموذج uncensored للوصول إلى نموذج مفتوح الأوزان الوحيد المستضاف على خوادمنا. هذا النموذج مُعدّ للإجابة دون رفض المحتوى للاستخدام القانوني للبالغين. عنوان URL الأساسي هو https://api.apertus.top/v1. الأسعار شفافة: 0.25 دولار لكل مليون رمز إدخال و1.00 دولار لكل مليون رمز إخراج. تدفع فقط مقابل ما تستخدمه.

Copycurl https://api.apertus.top/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."}]
  }'

يعيد الاستجابة النص المُولّد. إذا كان رصيدك غير كافٍ، ستتلقى خطأ في الفوترة. لا يتم تحميل حسابك عند حدوث أخطاء أثناء المعالجة. يمكنك شحن الرصيد باستخدام USDT (TRC20) أو USDC (Base) عبر لوحة التحكم.

تكامل SDK Python

استخدم حزمة SDK الرسمية الخاصة بـ OpenAI للغة Python أو أي عميل متوافق. اضبط base_url على https://api.apertus.top/v1 وقم بتوفير مفتاح API الخاص بك. يتيح لك ذلك الاستفادة من مجموعات الأكواد الموجودة المصممة لـ OpenAI. نقطة النهاية /v1/chat/completions تتعامل مع جميع عمليات توليد النصوص. معرف النموذج هو uncensored. المعلمات مثل temperature، top_p، وstop مدعومة. تتضمن استجابات البث المتدفق تفاصيل استخدام الرموز في الشريحة الأخيرة. استدعاء الدوال ووضع JSON متاحان أيضًا للمخرجات المهيكلة.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertus.top/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)

تكامل SDK Node.js

تهيئة العميل باستخدام عنوان URL الأساسي لـ Apertus. تقبل الفئة OpenAI معلمات التكوين القياسية. مرر مفتاح API الخاص بك واضبط عنوان URL الأساسي على https://api.apertus.top/v1. يضمن ذلك التوافق مع تطبيقات Node.js الموجودة. مطلوب معرف النموذج uncensored لجميع الطلبات. يمكنك التحكم في طول المخرجات باستخدام max_tokens. الحد الأقصى الافتراضي للمخرجات هو 2,048 رمزًا إذا لم يتم تحديده، مع حد أقصى صارم قدره 32,000 رمز لكل طلب.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertus.top/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: true في طلبك. تُرجع واجهة برمجة التطبيقات تدفق أحداث مرسلة من الخادم (SSE). تحتوي كل شريحة على نص جزئي. تتضمن الشريحة الأخيرة إحصائيات استخدام الرموز الكاملة للطلب. يتيح لك ذلك عرض النتائج في الوقت الفعلي مع تتبع التكاليف. يعمل البث المتدفق مع جميع المعلمات، بما في ذلك استدعاء الدوال. تأكد من أن عميلك يتعامل مع أحداث SSE بشكل صحيح. تدعم نافذة السياق ما يصل إلى 100,000 رمز للموجّه والإكمال معًا.

Copystream = 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)

الحدود، الأخطاء والسياق

تفرض واجهة برمجة التطبيقات حدًا قدره 300 طلب في الدقيقة لكل مفتاح وتسمح بـ 8 طلبات متزامنة. الحد الأقصى لحجم محتوى الطلب هو 8 ميجابايت. إذا كان مفتاح المصادقة غير صالح، تتلقى خطأ 401. إذا استنفد رصيدك المسبق للدفع، تتلقى خطأ 402 يشير إلى عدم كفاية الأموال. يتم تطبيق حدّ المعدل استنادًا إلى الحصة لكل دقيقة. نافذة السياق هي 100,000 رمز إجمالي. الحد الأقصى للمخرجات لكل طلب هو 32,000 رمز. الطلبات التي تتجاوز هذا الحد يتم التعامل معها من خلال السلوك القياسي للنموذج. لا توجد ضمانات لنسب اتفاقيات مستوى الخدمة. الخصوصية محفوظة؛ لا تُستخدم الموجّهات للتدريب.