توثيق واجهة برمجة التطبيقات: تكامل النموذج غير الخاضع للرقابة

البدء السريع: أرسل طلبك الأول

أسرع طريقة للتحقق من الاتصال هي مكالمة إكمال واحدة. استبدل المفتاح الوظيفي ببيانات الاعتماد الخاصة بك وشير العميل إلى عنوان URL الأساسي الخاص بنا. يستجيب النموذج على الفور دون تصفية المحتوى للإدخالات القانونية.

استخدم أمر cURL هذا لاختبار التكامل مباشرة من طرفيتك (terminal).

Copycurl https://api.howtouncensorgemini.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize the pros and cons of the current model."}]
  }'

المصادقة وURL الأساسي

يعتمد نظام الـ API الخاص بنا على مصادقة رمز حامل (Bearer token) قياسية. يجب أن تتضمن مفتاح API الفريد الخاص بك في رأس Authorization لكل طلب. عنوان URL الأساسي هو HTTPS://api.howtouncensorgemini.com/v1. هذه النقطة متوافقة مع أي إطار عمل OpenAI.

عند استخدام حزمة تطوير البرامج (SDK) الخاصة بـ Python، تحتاج فقط إلى تحديث عنوان URL الأساسي و api_key. تبقى باقي المعلمات مطابقة تمامًا للهيكل الرسمي لواجهة برمجة التطبيقات (API) الخاصة بـ OpenAI.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.howtouncensorgemini.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)

نقطة نهاية إكمال الدردشة

تحدث جميع التفاعلات عبر نقطة النهاية /v1/chat/completions. ترسل قائمة بالرسائل وتتلقى استجابة نصية. معرف النموذج هو دائمًا "uncensored". يتعامل هذا النموذج الوحيد مع جميع احتياجات التوليد دون الحاجة إلى منطق التوجيه.

إذا كنت تفضل جافا سكريبت، فإن حزمة Node SDK تتطلب إعداداً بسيطاً. حدد عنوان URL الأساسي وأمر مفتاحك. تتعامل المكتبة مع طلبات HTTP تلقائياً.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.howtouncensorgemini.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);

المعلمات والميزات المدعومة

ندعم معلمات قياسية مثل temperature و top_p وتسلسلات الإيقاف. يمكنك فرض وضع JSON باستخدام response_format. دعم استدعاء الأدوات كامل لدمج الوظائف. تعمل هذه الميزات تمامًا كما هو موثق في مواصفات OpenAI.

حدد حقل النموذج إلى "uncensored" في كل طلب. يضمن ذلك وصولك دائمًا إلى محرك الاستدلال الصحيح. يتجاهل النظام المعاملات غير المدعومة بسلاسة.

استخدام الرموز والبث

فعّل التدفق عن طريق تعيين stream إلى true. تتلقى أجزاء من النص بمجرد توليدها. يحتوي الجزء الأخير على إحصائيات استخدام الرموز الكاملة. يتيح ذلك لك تتبع التكاليف في الوقت الفعلي.

استخدم هذا المثال للتعامل مع استجابات التدفق بكفاءة في تطبيقك.

Copystream = 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)

حدود، أخطاء، والسياق

سعة نافذة السياق هي 100,000 رمز إجمالاً. يمكنك إخراج ما يصل إلى 16,000 رمز لكل طلب. حدود معدل الطلب هي 300 طلب في الدقيقة. يعني خطأ 401 أن مفتاحك غير صالح. يشير خطأ 402 إلى عدم كفاية الرصيد. يعني خطأ 429 أنك وصلت إلى حد معدل الطلب.