Dolphin غير خاضع للرقابة واجهة برمجة التطبيقات التوثيق

المتطلبات الأساسية وإعداد البيئة

ابدأ بتأكد من أن بيئتك تحتوي على التبعيات اللازمة المثبتة قبل إرسال أي طلبات. ستحتاج إلى مفتاح واجهة برمجة التطبيقات (API) النشط من لوحة التحكم الخاصة بنا وبيئة تشغيل مدعومة مثل Python أو Node.js. تتطلب واجهة برمجة التطبيقات (API) الخاصة بنا إرسال الطلبات إلى عنوان URL أساسي محدد بدلاً من نقطة نهاية OpenAI الافتراضية.

احفظ مفتاح API الخاص بك بأمان واحفظه في متغير بيئة. يمنع هذا التعرض العرضي في مستودع الكود الخاص بك. يمكنك إنشاء مفتاح جديد فوراً بعد التسجيل باستخدام Google أو البريد الإلكتروني.

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

تثبيت الحزمة البرمجية (SDK) الرسمية لـ OpenAI

ثبّت حزمة الحزمة الرسمية (SDK) للتعامل مع المصادقة وتنسيق الطلبات تلقائيًا. تدعم هذه المكتبة كل من بيئتي Python و Node.js بواجهات متسقة.

بالنسبة لمستخدمي Python، قم بتشغيل أمر تثبيت pip القياسي لإضافة المكتبة إلى بيئة افتراضية. يجب على مطوري Node.js استخدام npm لتثبيت الحزمة المكافئة.

يدير SDK هيكل حمولة JSON لك، لذا لا تحتاج إلا للتركيز على محتوى المطالبة والمعاملات مثل درجة الحرارة أو top_p.

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

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

وجّه عميل SDK الخاص بك إلى عنوان URL الأساسي المحدد لتوجيه الطلبات إلى البنية التحتية غير الخاضعة للرقابة لدينا. استخدم https://api.dolphinuncensored.com/v1 كـ endpoint الخاص بك.

قم بتعيين مفتاح API الخاص بك في رأس المصادقة أو كائن تكوين العميل. سيرفق العميل هذا المفتاح تلقائيًا إلى كل طلب.

تأكد من تحديد معرف النموذج كـ "uncensored" في تكوينك. يخبر هذا الخادم أي إصدار من النموذج يجب استخدامه لتوليدك.

إجراء أول إكمال للدردشة

أرسل رسالة بسيطة للتحقق من الاتصال وتلقي استجابة. يؤكد هذا أن مفتاحك صالح ونقطة النهاية قابلة للوصول.

استخدم نقطة نهاية chat-completions مع نظام توجيه (system prompt) ورسالة مستخدم. سيحتوي الرد على النص المُولّد في حقل content.

فهم التدفق واستهلاك الرموز

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

تُعيد الواجهة النصية (API) إحصائيات الاستخدام في الجزء الأخير من التدفق. يمكنك تتبع عدد رموز الإدخال والإخراج لشفافية الفوترة.

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

معالجة الأخطاء والرفض

التعامل مع أخطاء HTTP 401 عن طريق التحقق من صحة مفتاح API الخاص بك وعدم انتهائه. يشير خطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً؛ قم بالشحن عبر العملات المشفرة للمتابعة.

تعني حالة 429 أنك وصلت إلى حد معدل الطلبات البالغ 300 طلب في الدقيقة. انتظر لحظة قبل إعادة المحاولة أو قلل من التزامن.

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

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

التدفق

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)