دليل البدء السريع للدردشة في Dolphin ai

تثبيت و تكوين SDK

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

استخدم طريقة متغير البيئة للحفاظ على الأمان. عنوان URL الأساسي هو HTTPS://api.dolphinaichat.com/v1. هذا يعمل مع أي عميل متوافق مع OpenAI عن طريق تغيير base_url ومفتاح API.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

إجراء أول طلب POST

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

Copycurl https://api.dolphinaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit the daily server load statistics for the last week"}]
  }'

معالجة استجابات التدفق (SSE)

تمكين التدفق لتلقي الرموز في الوقت الفعلي. تدعم واجهة برمجة التطبيقات أحداث الإرسال من الخادم (SSE) للمخرجات التدريجية. تظهر تفاصيل استخدام الرموز في الحزمة الأخيرة من التدفق.

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)

فهم نوافذ السياق & الرموز

يدعم النموذج نافذة سياق بحجم 100,000 رمز مدمج للسياق (prompt) والإكمال (completion). الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. الحد الأقصى الافتراضي لـ max_tokens هو 2,048 إذا لم يتم تعيينه. التسعير هو 0.15$ لكل مليون رمز إدخال و0.50$ لكل مليون رمز إخراج.

رموز الأخطاء & تحديد المعدل

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

إعداد وضع JSON واستدعاء الوظائف

استخدام response_format: {"type": "json_object"} للمخرجات المُهيّأة. فعّل استدعاء الوظائف مع tools و tool_choice. المعاملات مثل درجة الحرارة و top_p مدعومة بالكامل.