دليل التكامل: واجهات برمجة تطبيقات OpenAI القياسية
اربط تطبيقك بواجهة برمجة تطبيقات abliterated llm باستخدام واجهات برمجة تطبيقات OpenAI القياسية. يغطي هذا الدليل المصادقة، الطلبات الأساسية، البث المتدفق، استدعاء الدوال، وحدود المفاتيح.
https://api.abliteratedapi.com/v1النموذجuncensoredالمتطلبات المسبقة
تحتاج إلى مفتاح API من لوحة تحكم Abliterated LLM API. أنشئ حسابًا باستخدام البريد الإلكتروني وكلمة المرور للحصول على مفتاحك فورًا. لا يتطلب الأمر بطاقة ائتمان للتجربة. عنوان URL الأساسي لجميع الطلبات هو https://api.abliteratedapi.com/v1.. يعمل هذا العنوان مع واجهات برمجة التطبيقات الرسمية (SDKs) الخاصة بـ OpenAI وأي عميل متوافق مع OpenAI عن طريق تعيين base_url وتقديم مفتاح API الخاص بك.
المصادقة
مرّر مفتاح API الخاص بك في رأس Authorization. يجب أن تكون القيمة Bearer YOUR_API_KEY. إذا كان المفتاح غير صالح، ستتلقى خطأ 401. إذا تم إلغاء صلاحية المفتاح بعد إعادة توليده، فسيؤدي ذلك أيضًا إلى إرجاع خطأ 401. إذا كان رصيدك غير كافٍ، ستتلقى خطأ 402. لا تنتهي صلاحية المفاتيح؛ بل يتم إبطالها فقط عند إعادة توليدها.
curl https://api.abliteratedapi.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."}]
}'
الإكمال الأساسي
أرسل طلب POST إلى /v1/chat/completions. معرف النموذج هو "uncensored". تقبل واجهة برمجة التطبيقات هياكل الرسائل القياسية. لا تُستخدم الموجّهات للتدريب. يستجيب النموذج بمخرجات نصية. يمكنك إرسال ما يصل إلى 8 ميجابايت لكل جسم طلب.
from openai import OpenAI
client = OpenAI(base_url="https://api.abliteratedapi.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)
الاستجابات المتدفقة
فعّل البث المتدفق عن طريق تعيين stream: true في طلبك. تُعيد الواجهة أحداثًا مرسلة من الخادم (SSE). يتيح لك ذلك معالجة الرموز (tokens) أثناء إنشائها. يعمل البث المتدفق مع جميع واجهات برمجة التطبيقات (SDKs) القياسية. استخدم ذلك لتحسين تجربة المستخدم في واجهات الدردشة.
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)
استدعاء الدوال
يدعم API Abliterated LLM استدعاء الدوال. عرّف الأدوات في جسم طلبك. يمكن للنموذج اختيار هذه الأدوات واستدعائها. يعمل ذلك بتنسيق OpenAI القياسي. تأكد من مطابقة تعريفات أدواتك لتوقعات واجهة برمجة التطبيقات (SDK). هذا مفيد لبناء وكلاء أو سير عمل آلي.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.abliteratedapi.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);
حدّ المعدل والحدود
أنت مقصور على 300 طلب في الدقيقة لكل مفتاح. نافذة السياق هي 100,000 رمز (token) للموجّه (prompt) والإكمال معًا. إذا تجاوزت حدّ المعدل، ستتلقى خطأ 429. لا يوجد اشتراك؛ الرصيد مسبق الدفع ولا ينتهي. تبدأ الإضافات بمبلغ 10 دولارات. يمنع حد محتوى صارم المحتوى الجنسي الذي يتضمن قاصرين.
مواصفات API
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| المصادقة | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.abliteratedapi.com/v1 |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| وضع JSON | response_format: {"type": "json_object"} |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| حجم الطلب | حتى 8 MB |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| مكافأة | +5% من $50، +10% من $100 |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
هل تنتهي صلاحية مفاتيح API؟
لا، لا تنتهي صلاحية مفاتيح API. يتم إبطالها فقط إذا قمت بإعادة توليد مفتاح جديد في لوحة التحكم الخاصة بك. يمكنك إعادة توليد مفتاحك في أي وقت، مما يؤدي إلى إلغاء صلاحية المفتاح القديم فورًا.
ما هو حجم نافذة السياق؟
حجم نافذة السياق هو 100,000 رمز (token). يشمل ذلك كل من الموجّه المدخل والإكمال الناتج. يمكنك إرسال ما يصل إلى 8 ميجابايت لكل جسم طلب.
ما هي المحتويات المحظورة؟
لا يرفض النموذج المواضيع القانونية للبالغين أو الخيالية أو المثيرة للجدل. ومع ذلك، ينطبق حد محتوى صارم دائمًا: يتم حظر المحتوى الجنسي الذي يتضمن قاصرين. يتم رفض الطلبات من هذا النوع.
مفتاحك على بُعد نموذج واحد
أنشئ حساباً، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد الكامل.
احصل على مفتاح API