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