البدء السريع: التكامل في دقائق

تثبيت SDK الرسمي

ابدأ بتثبيت مكتبة OpenAI الرسمية للغتك المفضلة. جمال واجهة برمجة التطبيقات الخاصة بنا هو أنها تستخدم مكتبات العملاء التي تعرفها بالفعل. لا تحتاج إلى مكتبة مخصصة أو نص إعداد معقد. pip install openai أو npm install openai يجعلك جاهزًا. يعني هذا النهج أن قاعدة الكود الحالية تتكيف بانخفاض الاحتكاك. يمكنك التبديل بين المزودين دون إعادة كتابة المنطق الأساسي.

تكوين عنوان URL الأساسي والمفتاح

وجّه عميلك إلى عنوان URL الأساسي المحدد وأدرج مفتاح API الخاص بك. تعيش نقطة النهاية لدينا على https://api.groknsfwprompts.com/v1. يضمن هذا الرابط وصولك مباشرة إلى نموذجنا غير المقيد. يجب عليك ضبط base_url المعامل في تكوين SDK الخاص بك. مرر مفتاحك عبر api_key الرأس. يتجاوز هذا الإعداد التوجيه الافتراضي لـ OpenAI. وهو يضمن أنك تتحدث مع خوادمنا، وليس خوادمهم.

إليك كيفية تكوين الاتصال في طلب قياسي:

Copycurl https://api.groknsfwprompts.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Describe a cybernetic woman in a neon city"}]
  }'

أرسل طلبك الأول

أرسل إكمال محادثة بسيط للتحقق من اتصالك. استخدم معرف النموذج uncensored لجميع الطلبات. يشير هذا المعرف إلى نموذجنا مفتوح الوزن والمُدرّب على المحتوى البالغ. أرسل مطالبة قد تُفعل عادةً مرشح المحتوى. سيعيد النموذج النص الخام دون رفض. تحصل على مخرجات نصية فورية لاحتياجات هندسة المطالبات الخاصة بك. تؤكد هذه الخطوة أن رصيد الائتمان الخاص بك نشط.

جرّب هذا البرنامج النصي البسيط بلغة Python للتحقق من الاتصال:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.groknsfwprompts.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 في معاملات الطلب الخاص بك. سيقوم مكتبة التطوير (SDK) بإرجاع الشرائح بمجرد توفرها. هذا أمر بالغ الأهمية لتوليد موجهات الفيديو حيث تريد تغذية راجعة فورية. يمكنك إلغاء التدفق إذا انحرف الرد عن المسار الصحيح. يوفر تجربة مطور أكثر سلاسة للاختبار التكراري.

إليك نمط تنفيذ التدفق:

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 الصارم. يضمن هذا استلام المحللين اللاحقين بيانات صالحة. يمكنك أيضًا تعريف الأدوات لاستدعاء الوظائف. يدعم النموذج تعريفات الأدوات القياسية وخياراتها. هذه الميزة حيوية لخطوط أنابيب توليد مطالبات NSFW الآلية. فهي تحافظ على هيكل بياناتك متوقعًا ونظيفًا.

شاهد كيفية تفعيل وضع JSON في Node.js:

Copyimport OpenAI from "openai";

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

فهم حدود الرموز وتسعيرها

راقب استخدامك مقابل حدودنا الواضحة. نفرض رسومًا بمبلغ $0.15 لكل مليون رمز مميز للإدخال و $0.50 لكل مليون رمز مميز للإخراج. تمتد نافذة السياق الخاصة بك إلى 100,000 رمز مميز في المجموع. يمكنك إخراج ما يصل إلى 16,000 رمز مميز لكل طلب. تحد حدود معدل الطلب من 300 طلب في الدقيقة. تعامل مع الأخطاء مثل 402 (لا يوجد رصيد) أو 429 (حد معدل الطلب) بسلاسة. الأخطاء والرفضات لا تستهلك رصيدك. يفضل هذا النموذج سير عمل هندسة الطلبات الثقيلة.