اربط عميل chat completions نصيًا بـ Ablitron. سجّل في لوحة التحكم واشحن رصيدك لاستخدام البوابة.
النماذج
ablitron-pro (سياق 1M توكن، يعتمد على نسخة معدَّلة من GLM-5.3) وablitron-core (سياق 256K توكن، بنصف السعر) نموذجان من نوع abliterated. هذه أسماء خدمات، وليست ادعاءً بأن Ablitron درّب النموذج الأساسي. ولم تُقَس جودة البرمجة بعد.
1. أنشئ مفتاح API
افتح لوحة التحكم، وأنشئ حسابًا، وأكّد بريدك الإلكتروني. أنشئ مفتاحًا وانسخه (يظهر مرة واحدة فقط)، واحفظه في بيئة الخادم لديك. يمكن إلغاء المفاتيح من اللوحة نفسها. أضف رصيدًا مدفوعًا مسبقًا أو اختر اشتراكًا شهريًا.
2. أرسل طلبًا
عنوان base URL للإنتاج: https://ablitron.com/v1. وللتطوير المحلي استخدم http://localhost:4174/v1. احفظ مفتاحك في ABLITRON_API_KEY.
curl https://ablitron.com/v1/chat/completions \
-H "Authorization: Bearer $ABLITRON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"ablitron-core","messages":[{"role":"user","content":"Write a Python binary search."}],"max_tokens":2048}'
3. البث أو استدعاء الأدوات
أضف "stream": true لتلقي أحداث server-sent events تحتوي على أجزاء الإكمال والاستخدام النهائي وعلامة [DONE]. تستخدم تعريفات الدوال المصفوفة tools؛ وأعِد نتائج الأدوات في رسائل بالدور tool مع قيمة tool_call_id المطابقة. العميل هو من ينفّذ الأدوات؛ ولا ينفّذ Ablitron شيفرتك.
حدود الإدخال والإخراج
تدعم المعاينة الرسائل النصية فقط، بحدّ أقصى 10,000 رسالة و64 أداة. حد الإخراج 1–16,384 توكن، والقيمة الافتراضية 2,048. استخدم إما max_tokens أو max_completion_tokens، لا كليهما. لا يوجد حد إضافي للتوكنات على الإدخال خلال المعاينة. يفرض المزوّد نافذة السياق الخاصة بالنموذج المختار. يقتصر حجم جسم طلب HTTP على 16 MB، ويلزم وجود خطة لم تستنفد حدودها، أو رصيد مدفوع مسبقًا يكفي لحجز الطلب. يُدعم إكمال واحد فقط لكل طلب.
الخطط والرصيد والفوترة
مع الخطة، يُحتسب كل طلب ضمن حدودها لكل 5 ساعات وللأسبوع وللشهر، مقيسًا بأسعار التوكنات. عند بلوغ أحد الحدود، أو في غياب خطة، تستخدم الطلبات الرصيد المدفوع مسبقًا: فهي تحجز رصيدًا قبل الاستدلال بناءً على حجم إدخال تقديري متحفظ وأقصى إخراج مطلوب، ثم يُحتسب الخصم النهائي وفق استخدام التوكنات المُبلَّغ عنه. الإدخال المخزَّن مؤقتًا (cached) جزء من الإدخال ويُحتسب بسعره الأقل. توكنات التفكير (reasoning) مشمولة أصلًا في الإخراج ولا تُحتسب مرتين.
الأخطاء وإعادة المحاولة
- 400
- طلب غير صالح أو غير مدعوم. تحقّق من الرسائل وحدود الإخراج.
- 401
- مفتاح مفقود أو ملغى أو غير نشط.
- 403
account_suspended: الحساب المرتبط بالمفتاح معلَّق. تواصل مع الدعم.- 402
- الرصيد المتاح غير كافٍ للحجز. أضف رصيدًا أو اخفض حد الإخراج.
- 429
- تجاوز حد المعدّل (افتراضيًا 120 طلبًا في الدقيقة لكل شبكة ولكل مفتاح، أو قيمة
key_rate_limitالخاصة بالمفتاح)، أو وجود أربعة طلبات قيد التنفيذ بالفعل، أوkey_usage_limit: بلغ المفتاح حد الاستخدام اليومي أو الشهري المعيَّن له في Settings → API keys، أوusage_limit: بلغت خطتك حدها وليس لديك رصيد مدفوع مسبقًا. يوضّحerror.resets_at(بتوقيت Unix) والترويسةRetry-Afterموعد التجدد. - 502
- تعذّر تأكيد استجابة النموذج أو الاستخدام. راجع لوحة التحكم قبل إعادة المحاولة.
- 503
- الاستدلال أو خدمة مطلوبة أخرى غير مفعَّلة.
احفظ ترويسة الاستجابة X-Request-ID عند الإبلاغ عن مشكلة. لا تُعاد محاولة الاستدلال تلقائيًا. إذا تعذّر تأكيد الاستخدام بعد انقطاع الاتصال أو خطأ في الخادم، يبقى الحجز معلّقًا لمدة 15 دقيقة؛ ثم يُسوّى بتقدير متحفظ للنص الذي تلقيته، أو يُحرَّر دون أي خصم إذا لم يُسلَّم شيء. تنتهي الطلبات التي لا تستخدم البث بعد نحو 170 ثانية بالخطأ 504 request_timeout؛ وتُحتسب المطالبة بتقدير، لذا استخدم البث للإجابات الطويلة. إعادة المحاولة طلب جديد وقد تستهلك استخدامًا إضافيًا.
البيانات التي تعالجها البوابة
تُمرَّر الطلبات إلى مزوّد استدلال. يخزّن سجل الاستخدام المحلي معرّفات الطلبات والطوابع الزمنية والأسماء المستعارة للنماذج وأعداد التوكنات والرسوم، ولا يخزّن نص المطالبات أو المخرجات. تُخزَّن مفاتيح API الخاصة بالعملاء كقيم hash. يجب مراجعة طريقة معالجة البيانات لدى المزوّد وشروط الخدمة المعمول بها لحالة استخدامك؛ ولا ندّعي عدم الاحتفاظ بالبيانات على امتداد المسار كاملًا.