Dolphin AI Integration Guide

المتطلبات الأساسية: إعداد حزمة التطوير (SDK) ومفتاح API

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك. أنشئ حسابًا عبر البريد الإلكتروني أو تسجيل الدخول بحساب Google على لوحة التحكم. أنشئ مفتاح API الخاص بك فورًا. لا نحتاج إلى رقم هاتف. يظهر المفتاح مرة واحدة على الشاشة. احفظه بأمان. لا نخزن طريقة الدفع الخاصة بك. تستخدم الإضافات عبر العملات المشفرة USDT أو USDC. الرصيد لا ينتهي. الأخطاء لا تكلف شيئًا. تدفع فقط مقابل الرموز المستخدمة.

ضبط عنوان URL الأساسي والرؤوس

وجّه عميلك إلى عنوان URL الأساسي. اضبط رأس المصادقة بمفتاحك. استخدم معرف النموذج "uncensored". يضمن هذا أنك تصل إلى النموذج غير الخاضع للرقابة لدينا. إنه ليس GPT أو Claude. تقبل نقطة النهاية إكمال الدردشة القياسي. يجب أن تتضمن الرؤوس مفتاح API. الحقول الأخرى اختيارية. تعمل درجة الحرارة و top_p كما هو متوقع. ندعم معايير OpenAI القياسية. تحقق من الوثائق لمعرفة الحدود.

Copycurl https://api.dolphinllmmodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the max token limit for this endpoint?"}]
  }'

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

أرسل طلب POST مع رسائلك. ضمّن نص النظام للسياق. عيّن محتوى رسالة المستخدم. يعيد النموذج استجابة نصية. يمكنك تحديد الحد الأقصى للرموز. المخرجات الافتراضية هي 2,048 رمزًا. اضبط حدودًا أعلى إذا لزم الأمر. نافذة السياق هي 100,000 رمز. يتشارك الإدخال والإخراج هذا الحد. تأكد من أن النص المناسب يتسع. الأخطاء تعيد أكواد JSON قياسية. تحقق من جسم الاستجابة للأخطاء.

Copyfrom openai import OpenAI

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

تمكين التدفق للحصول على استجابات فورية

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

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)

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

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

Copyimport OpenAI from "openai";

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

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

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