AR ▾
احصل على مفتاح API

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 URLhttps://api.chatbotapis.com/v1
نافذة السياق100,000 رمز (المدخلات والمخرجات معاً)
وضع JSONresponse_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 ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.

الرمزالنوعالمعنى
400bad_requestJSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق
401missing_key · invalid_key · key_revokedلا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله
402no_creditالرصيد فارغ — اشحن وتستأنف الطلبات فوراً
403content_blockedمحتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب
404not_foundنقطة نهاية غير معروفة
413request_too_largeجسم الطلب أكبر من 8 MB
429rate_limited · concurrencyتجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة
503upstream_busyالنموذج مشغول — أعد المحاولة بعد ثوانٍ