البدء السريع لنموذج Dolphin ai

ثبّت الحزمة البرمجية (SDK) المفضلة لديك

ابدأ بتثبيت المكتبة للغتك. تتعامل هذه الحزمة مع التسلسل والمصادقة تلقائياً.

قم بتشغيل الأمر لبيئتك. يضيف التبعيات اللازمة إلى مشروعك.

• Python: pip install openai
• Node.js: npm install openai

تدعم هذه المكتبات البرمجية (SDKs) نفس الواجهات المستخدمة من قبل المزودين الكبار. تحصل على أنواع الأخطاء القياسية وكائنات الاستجابة.

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

وجّه عميلك إلى نقطة النهاية المستضافة لدينا. استبدل العنوان الافتراضي بعنوان URL الأساسي المحدد لدينا.

• URL الأساسي: https://api.dolphinaimodel.com/v1
• معرف النموذج: uncensored

قم بتعيين مفتاح API الخاص بك في متغير البيئة OPENAI_API_KEY. يقرأ مكتبة البرمجيات (SDK) هذا تلقائيًا. تستخدم المصادقة رؤوس رمز حامل قياسية. لا توجد رؤوس خاصة مطلوبة.

يعمل هذا مع أي عميل متوافق مع OpenAI. تتجنب تعقيد الوكيل باستخدام الواجهة المباشرة القياسية.

أرسل أول إكمال

أجرِ طلب POST إلى /v1/chat/completions. يجيب النموذج بحرية للاستخدام القانوني للبالغين. لا يرفض المواضيع المثيرة للجدل أو الصريحة بشكل افتراضي.

أرسل تلميحك في مصفوفة الرسائل. تحتوي الاستجابة على النص المُولّد في حقل المحتوى. يمكنك ضبط درجة الحرارة و top_p للتحكم.

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

تعيد الأخطاء رموز حالة HTTP القياسية. تحقق من جسم الاستجابة للحصول على تفاصيل حول الفشل.

التعامل مع استجابات التدفق

فعّل البث عن طريق تعيين stream: true. يرسل الخادم أجزاء عبر أحداث الحدث المرسلة من الخادم (SSE). يحتوي كل جزء على نص جزئي.

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

يعمل البث مع جميع المعلمات. يمكنك الإيقاف في منتصف التدفق إذا لزم الأمر. يغلق الاتصال بشكل نظير بعد الاكتمال.

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

استخدم الأدوات ووضع JSON

حدد تعريفات الوظائف في الطلب. يمكن للنموذج استدعاء هذه الوظائف بناءً على طلبك. استخدم tool_choice لإجبار سلوك محدد.

تمكين وضع JSON مع response_format. المخرج مُنسق بدقة ككائن JSON. يضمن هذا تحليلًا موثوقًا به في كودك.

ادمج الأدوات مع التدفق لعمليات العمل المعقدة. يمكنك التعامل مع استدعاءات وظائف متعددة في دورة واحدة. يتبع النموذج مخططك بدقة.

اختبر باستخدام أدوات بسيطة أولاً. تحقق من هيكل الإخراج قبل الدمج في أنظمة الإنتاج.

إدارة حدود الرموز

نافذة السياق هي 100,000 رمز إجمالاً. هذا يشمل رموز الإدخال والإخراج معاً. خطط لجمالك المدخلة وفقاً لذلك.

الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. إذا لم تضبط max_tokens, الحد الافتراضي هو 2,048. اضبط هذا المعامل للحصول على استجابات أطول.

حدود معدل الطلبات هي 300 طلب في الدقيقة. يمكنك إجراء 8 طلبات متزامنة لكل مفتاح. يؤدي تجاوز هذه الحدود إلى إرجاع رمز حالة 429.

راقب استهلاكك عبر رؤوس الاستجابة. تتضمن كل استجابة عدد الرموز. يساعدك هذا في البقاء ضمن حدود رصيدك المدفوع مسبقاً.

cURL

Copycurl https://api.dolphinaimodel.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate the factorial of 42"}]
  }'

Python

Copyfrom openai import OpenAI

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