توثيق واجهة برمجة التطبيقات

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

قم بتوصيل تطبيقك عن طريق التوجيه إلى نقطة النهاية المخصصة لدينا وإدخال مفتاح API الفريد الخاص بك. عنوان URL الأساسي لجميع الطلبات هو https://api.apertusapp.com/v1. تحصل على مفتاحك فورًا بعد التسجيل عبر Google أو البريد الإلكتروني على احصل على مفتاح API صفحة. أضف هذا المفتاح في Authorization الرأس لكل طلب.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

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

الطلب الأول

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

Copyfrom openai import OpenAI

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

تقبل واجهة برمجة التطبيقات (API) المعايير القياسية مثل temperature و top_p. الأخطاء والرفض لا تستهلك رموزًا، لذا تدفع فقط مقابل ما يصل فعليًا إلى النموذج. يحافظ هذا النهج على التكاليف المتوقعة مقارنة بالمجمعين الذين يتقاضون رسومًا مقابل تجاوز التوجيه.

تكامل Node SDK

استخدم مكتبة Node SDK الرسمية للتعامل مع وضع JSON واستدعاء الوظائف بكفاءة. اضبط response_format إلى {"type": "json_object"} للمخرجات المُهيّأة أو تعريف الأدوات لسلوك شبيه بالوكلاء.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusapp.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);

يدعم النموذج استدعاء الأدوات مع tool_choice خيارات. يمكنك أيضًا تعيين seed لنتائج حتمية. يسمح هذا المرونة ببناء تطبيقات معقدة دون مغادرة بيئة التوافق مع OpenAI.

استجابات البث

قم بتدفق الرموز في الوقت الفعلي باستخدام أحداث الإرسال عبر الخادم (SSE) لتجارب مستخدم منخفضة زمن الاستجابة. تحتوي كل كتلة على النص المُولّد، وتضمّن الكتلة الأخيرة إحصائيات استخدام الرموز الإجمالية.

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)

يقلل التدفق من زمن الاستجابة المُدرَك للمستخدمين النهائيين. يمكنك مقاطعة التدفق إذا غيّر المستخدم رأيه. تتعامل واجهة برمجة التطبيقات مع بروتوكول SSE تلقائياً، مما يتطلب الحد الأدنى من الكود من جانبك.

نافذة السياق والسعة

يدعم النموذج نافذة سياق بحجم 100,000 رمز لكل من الإدخال والإخراج معاً. يمكنك تحديد ما يصل إلى 16,000 رمز لكل طلب، أو العودة إلى 2,048 رمز إذا لم تحدد max_tokens.

يتيح هذا النافذة الواسعة تحليل المستندات بشكل موسع أو حفظ سجلات المحادثات الطويلة. ومع ذلك، حافظ على حجم جسم الطلب أقل من 8 ميجابايت. النموذج ليس GPT أو Llama؛ إنه نموذج ذكاء اصطناعي غير خاضع للرقابة مميز ومُحسّن لحالتك الاستخدامية المحددة.

معالجة الأخطاء والحدود

تعامل مع أخطاء HTTP القياسية بسلاسة للحفاظ على تدفق تطبيق قوي. A 401 خطأ يشير إلى مفتاح API غير صالح أو مفقود. A 402 خطأ يعني أن رصيدك المدفوع مسبقاً قد استنفد. A 429 خطأ يشير إلى أنك تجاوزت حد 300 طلب في الدقيقة أو 8 طلبات متزامنة.

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