توثيق واجهة برمجة التطبيقات: دليل البدء السريع

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

استخدم عنوان URL الأساسي الخاص بنا وأدخل مفتاح API الخاص بك في Authorization رأس لبدء إرسال الطلبات. نوفر نقطة نهاية واحدة تقبل حمولات OpenAI القياسية، لذا لا تحتاج إلى إعادة كتابة منطق التكامل الخاص بك. سجّل عبر Google أو البريد الإلكتروني للحصول على مفتاحك فوراً بدون رقم هاتف. يصادق المفتاح على حسابك ضد خوادمنا في كل مكالمة تقوم بها.

• URL الأساسي: https://api.geminisincensura.com/v1
• معرف النموذج: uncensored

يمكنك تدوير المفتاح الخاص بك في أي وقت من خلال توليد مفتاح جديد، مما يؤدي إلى إبطال الرمز السابق على الفور.

Copycurl https://api.geminisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how to configure the proxy endpoint"}]
  }'

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

أرسل طلب POST إلى /v1/chat/completions لتلقي استجابات نصية من نموذجنا غير المقيد. يتعامل هذا الرابط مع جميع احتياجات المحادثة القياسية لديك مع نافذة سياق تتكون من 100,000 رمز لكل من النص المدخل والاستجابة معًا. يمكنك تحديد حد أقصى للإخراج يبلغ 16,000 رمز، أو ترك النموذج ليستخدم القيمة الافتراضية البالغة 2,048 رمز. يجيب النموذج دون رفض المواضيع القانونية للبالغين أو الخيالية أو المثيرة للجدل، مما يمنحك حرية حقيقية لحالة الاستخدام الخاصة بك. لا تستهلك الأخطاء والرفض رصيدك المدفوع مسبقًا.

Copyfrom openai import OpenAI

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

استجابات البث عبر SSE

تدفق الاستجابات في الوقت الفعلي باستخدام أحداث Server-Sent (SSE) لتقليل زمن الاستجابة المُدرَك للمستخدمين. تحتوي كل كتلة على فرق النص، وتشمل الكتلة الأخيرة إحصائيات استخدام الرموز الكاملة لشفافية الفواتير. تعمل هذه الطريقة بسلاسة مع مكتلات OpenAI القياسية عن طريق تمكين التدفق في تكوين عميلك. تحصل على ملاحظات فورية بينما يولد النموذج مخرجات أطول حتى حد 16,000 رمز.

Copyimport OpenAI from "openai";

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

استدعاء الوظائف والأدوات

تمكين استخراج البيانات المهيكلة باستخدام tools المعامل في حمولة الطلب الخاصة بك. يدعم النموذج تعريفات الأدوات ويمكنه اختيار استدعاءها بناءً على tool_choice الإعدادات. تتيح لك هذه الميزة بناء وكلاء يتفاعلون مع الأنظمة الخارجية أو يفرضون هياكل بيانات محددة. وضع JSON متاح أيضًا عبر response_format لتنسيق المخرجات الصارم دون عبء الأدوات.

وضع JSON وتنسيق الاستجابة

فرض النموذج على إخراج JSON صالح عن طريق تعيين response_format إلى {"type": "json_object". هذا يضمن تحليلًا متوقعًا لتطبيقاتك بدون الحاجة إلى معالجة لاحقة. يلتزم النموذج بالمخطط الذي تقدمه، مما يجعله موثوقًا لتكاملات الخلفية. يمكنك الجمع بين هذا ومعاملات درجة الحرارة و top_p للتحكم في الإبداع مع الحفاظ على السلامة الهيكلية.

حدود المعدلات والقيود

مقيد كل مفتاح API بـ 300 طلب في الدقيقة و8 طلبات متزامنة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت، وهو كافٍ لمعظم تفاعلات السياق الطويل. إذا تجاوزت هذه الحدود، ستتلقى رمز حالة 429. تُرجع المفاتيح غير الصالحة خطأ 401، وعدم كفاية الرصيد يُرجح خطأ 402. لا تنتهي صلاحية رصيدك المدفوع مسبقاً، لذا يمكنك إيقاف الاستخدام دون فقدان الأموال. تدعم نافذة السياق ما يصل إلى 100,000 رمز إجمالاً، مما يسمح بتاريخ محادثات موسع.

التدفق

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)