توثيق API الخاص بـ Dolphin nsfw

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

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

• URL الأساسي: https://api.dolphinnsfw.com/v1
• المصادقة: رمز حامل في Authorization رأس.

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

الطلب الأول

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

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

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

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

تكامل واجهة برمجة تطبيقات Python

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

ثبّت المكتبة. قم بتهيئة العميل. أرسل الرسائل. يحتوي كائن الاستجابة على النص المُولّد. يمكنك الوصول إلى استخدام الرموز المميزة (tokens) من الاستجابة. يساعد ذلك في تتبع التكاليف.

Copyfrom openai import OpenAI

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

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

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

Copyimport OpenAI from "openai";

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

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

استخدام التدفق والأدوات

تمكين التدفق للإخراج في الوقت الفعلي. اضبط معلمة التدفق على true. ترسل واجهة برمجة التطبيقات كتلًا عبر أحداث Server-Sent. يقلل هذا من زمن الاستجابة المُدرَك. يرى المستخدمون النص أثناء توليده.

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

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)

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

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

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

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

الأسعار شفافة. تكلف رموز الإدخال $0.15 لكل مليون. تكلف رموز الإخراج $0.50 لكل مليون. الأخطاء لا تستهلك الرصيد. هذا يحمي ميزانيتك. الرصيد المسبق لا ينتهي. استخدم رصيد التجربة للاختبار أولاً.