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

تثبيت وتكوين SDK

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

URL الأساسي: HTTPS://api.uncensoredpromptgenerator.com/v1

مفتاح واجهة برمجة التطبيقات: المفتاح الفريد الخاص بك من لوحة التحكم.

Copycurl https://api.uncensoredpromptgenerator.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital city of Peru?"}]
  }'

أرسل أول إكمال للدردشة

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

استخدم حزمة Python SDK للبرمجة السريعة أو Node.js لتطبيقات الخادم. تتعامل كلتا المكتبتين مع النقل عبر HTTP تلقائيًا.

Copyfrom openai import OpenAI

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

الاستجابات التدفقية والاستخدام

فعّل البث عن طريق تعيين stream=true. يعيد API أحداث الإرسال عبر الخادم (SSE) لتسليم الرموز في الوقت الفعلي. تحتوي القطعة الأخيرة على إحصائيات الاستخدام لشفافية الفوترة.

يقلل هذا النهج من زمن الوصول المدرك للمستخدمين النهائيين. يمكنك معالجة الرموز أثناء وصولها دون انتظار الاكتمال الكامل.

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)

استدعاء الوظائف ووضع JSON

عرّف الأدوات في طلبك لتمكين استدعاء الوظائف. يدعم النموذج الإخراج المهيكلي وتنفيذ الأدوات. استخدم response_format مع {"type": "json_object"} للتوافق الصارم مع JSON.

يضمن ذلك تحليلًا موثوقًا في منطق تطبيقك. تعزز الأدوات قدرة النموذج على التفاعل مع الأنظمة الخارجية أو تنسيقات البيانات المهيكلة.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredpromptgenerator.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، و seed. تدعم نافذة السياق ما يصل إلى 100,000 رمز إجماليًا. الحد الأقصى للإخراج هو 16,000 رمز في كل طلب.

عدّل هذه الإعدادات لتحقيق التوازن بين الإبداع والحتمية. الحد الافتراضي للرموز هو 2,048 إذا لم يتم تحديده. استخدم stop تسلسلات لإيقاف التوليد عند علامات محددة.

حدود المعدلات ومعالجة الأخطاء

عالج الأخطاء بسلاسة من خلال التحقق من رموز حالة HTTP. يشير الرمز 401 إلى أن مفتاح API غير صالح. يعني الرمز 402 أن رصيدك المدفوع مسبقاً قد استنفد. يشير الرمز 429 إلى تجاوزك لحد معدل الطلبات البالغ 300 طلب في الدقيقة.

يتيح كل مفتاح 8 طلبات متزامنة. يجب أن يبقى حجم جسم الطلب أقل من 8 ميجابايت. لا تُصدر استرداداً للرصيد المستهلك، لكن الأخطاء لا تستهلك الرموز.