Unlimited AI API: البدء السريع الدليل
احصل على مفتاح API وابدأ بإرسال طلبات النصوص في دقائق. يغطي هذا الدليل عنوان URL الأساسي، والمصادقة، ونقاط النهاية القياسية المتوافقة مع OpenAI لنموذجنا اللغوي الكبير بدون رقابة.
عنوان URL الأساسي والمصادقة
تتوافق واجهة برمجة التطبيقات لدينا تمامًا مع تنسيق SDK الخاص بـ OpenAI. يجب عليك تعيين عنوان URL الأساسي إلى https://api.unlimitedaiapi.com/v1. يضمن ذلك توجيه جميع الطلبات إلى النموذج المخصص بدون رقابة، وليس إلى وسيط أو مجمع. يعتمد المصادقة على رمز Bearer في رأس Authorization. يمكنك إنشاء مفتاحك فورًا بعد تسجيل الدخول باستخدام البريد الإلكتروني وكلمة المرور فقط. يظهر المفتاح مرة واحدة بعد التسجيل، ولكن يمكنك تجديده في أي وقت، مما يلغي سريان المفتاح القديم. لا نطلب رقم هاتف أو بطاقة ائتمان للطبقة التجريبية.
الطلب الأول
ابدأ بإرسال طلب إكمال دردشة بسيط. يؤكد ذلك أن مفتاح API الخاص بك يعمل ويعطيك فكرة عن سرعة الاستجابة. معرف النموذج هو دائمًا uncensored. يمكنك إرسال رسائل متعددة في طلب واحد للحفاظ على السياق. يقبل النموذج تنسيقات رسائل OpenAI القياسية. لا توجد قواعد توجيه معقدة أو غرائب خاصة بالبائع تحتاج إلى إدارتها.
curl https://api.unlimitedaiapi.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."}]
}'تحقق من الاستجابة بحثًا عن مصفوفة choices التي تحتوي على النص المولد. إذا حصلت على خطأ 401، تحقق من مفتاح API الخاص بك. يعني خطأ 402 أن رصيدك المسبق الدفع قد استنفد.
تكامل SDK لـ Python
يُسهّل استخدام مكتبة openai الرسمية للغة Python عملية التكامل. قم بتعيين base_url و api_key في تهيئة العميل. يعمل هذا النهج مع المكالمات المتزامنة، وهي الوضع القياسي لمعظم البرامج النصية. ندعم إدخال وإخراج النصوص القياسية. لا نقدم التضمينات أو توليد الصور، لذا ركّز حمولة البيانات على النصوص فقط. تتعامل SDK مع الترميز تلقائيًا، لذا لا تحتاج إلى عد الرموز يدويًا للاستخدام الأساسي.
from openai import OpenAI
client = OpenAI(base_url="https://api.unlimitedaiapi.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)تأكد من استخدام إصدار حديث من SDK لدعم المعلمة base_url بشكل صحيح. يربط هذا الإعداد مباشرة ببنيتنا التحتية دون طبقات توجيه من طرف ثالث.
استخدام SDK لـ Node.js
في بيئات Node.js، تعمل الحزمة الرسمية openai بإعدادات قليلة. مرر مفتاح API الخاص بك وعنوان URL الأساسي الصحيح أثناء التهيئة. يتيح لك ذلك الاستفادة من بنية Node.js الحالية مع الحفاظ على التحكم الكامل في مكالمات API. ندعم أنماط الطلب والاستجابة القياسية. يتم التعامل مع البث المتدفق بشكل منفصل عبر أحداث Server-Sent. النموذج هو نموذج مفتوح الأوزان مُعدّل لرفض أقل، مما يجعله مناسبًا للمواضيع الإبداعية أو المثيرة للجدل ضمن الحدود القانونية.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unlimitedaiapi.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);تذكر أننا نحسب حسب الرمز، لذا راقب استخدامك عبر رؤوس الاستجابة أو لوحة التحكم. لا توجد رسوم خفية أو اشتراكات شهرية.
الاستجابات المتدفقة
يمكنك تمكين البث المتدفق عن طريق تعيين المعلمة stream إلى true في طلبك. تُرجع واجهة برمجة التطبيقات أحداث Server-Sent (SSE) بدلاً من كائن JSON واحد. يقلل هذا من زمن الاستجابة المُدرَك للمخرجات الطويلة. يحتوي كل جزء على جزء جزئي من الاستجابة. يجب عليك تجميع هذه الأجزاء الجزئية لإعادة بناء النص الكامل. يظل التسعير قائمًا على إجمالي الرموز المدخلة والمخرجة المعالجة، بغض النظر عن البث المتدفق. هذا مثالي لواجهات المستخدم التي تريد عرض النص أثناء إنشائه.
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)عالج تحليل SSE بعناية لتجنب تسرب الذاكرة إذا انقطع الاتصال بشكل غير متوقع. تنطبق نافذة السياق ذات 100,000 رمز على تاريخ المحادثة بأكمله، وليس فقط الدور الحالي.
الحدود والأخطاء والسياق
مفتاح API الخاص بك محدود بـ 300 طلب في الدقيقة. إذا تجاوزت هذا الحد، ستتلقى خطأ حدّ المعدل 429. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. يمتلك النموذج نافذة سياق بحجم 100,000 رمز، يجمع بين رموز الموجّه وإكمال النص. هذا كافٍ لمعظم مهام المستندات الطويلة. لا نقدم ضبط النماذج أو توجيه النماذج. إذا كنت بحاجة إلى التضمينات، فيجب عليك استخدام خدمة منفصلة. يحدّ المحتوى الصارم من المحتوى الجنسي الذي يتضمن قاصرين، لكنه يسمح بخلاف ذلك بالمواضيع القانونية والبالغين والمثيرة للجدل. تشير الأخطاء مثل 401 إلى مفتاح غير صالح، بينما تشير 402 إلى عدم كفاية رصيد مسبق الدفع.
مواصفات API
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| Base URL | https://api.unlimitedaiapi.com/v1 |
| المصادقة | Authorization: Bearer YOUR_KEY |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| معرّف النموذج | uncensored |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| وضع JSON | response_format: {"type": "json_object"} |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حجم الطلب | حتى 8 MB |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| مكافأة | +5% من $50، +10% من $100 |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| تسجيل الدخول | 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 | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
هل يعمل النموذج بدون رقابة مع أدوات OpenAI القياسية؟
نعم، واجهة برمجة التطبيقات الخاصة بنا متوافقة تمامًا مع OpenAI. يمكنك استخدام نقطة النهاية القياسية لإكمال الدردشة مع أي SDK أو عميل OpenAI يدعم تكوين <code>base_url</code>. ندعم استدعاء الدوال/الأدوات والبث عبر SSE.
كيف يعمل التسعير للاستجابات المتدفقة؟
يعتمد التسعير على إجمالي عدد رموز الإدخال والإخراج التي تمت معالجتها، بغض النظر عما إذا كنت تستخدم البث أو الاستجابات القياسية. يؤثر البث على زمن الاستجابة فقط، وليس التكلفة لكل رمز. تدفع $0.25 مقابل كل مليون رمز إدخال و$1.00 مقابل كل مليون رمز إخراج.
هل يمكنني استخدام واجهة برمجة التطبيقات هذه لتوليد الصور أو الصوت؟
لا، نقدم فقط توليد النصوص عبر نقطة النهاية <code>chat-completions</code>. لا ندعم التضمينات أو توليد الصور أو الصوت أو الفيديو. إذا كنت بحاجة إلى هذه القدرات، فستحتاج إلى دمج خدمة مختلفة لتلك الخطوات المحددة.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر عنوان URL الأساسي. هذا هو الإعداد بأكمله.