توثيق API عبر الإنترنت لـ Dolphin llm

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

عنوان URL الأساسي لجميع الطلبات هو HTTPS://api.dolphinllmonline.com/v1. تقوم بالمصادقة عن طريق تمرير مفتاح API الخاص بك في رأس المصادقة (Authorization header) كرمز حامل (Bearer token). يتم إنشاء هذا المفتاح فوراً بعد التسجيل باستخدام حساب Google أو عنوان بريد إلكتروني. لا توجد رسوم شهرية، ولا تنتهي صلاحية الرصيد. يمكنك امتلاك مفتاح نشط واحد فقط لكل حساب، لذا فإن إنشاء مفتاح جديد يحل محل المفتاح السابق.

Copycurl https://api.dolphinllmonline.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all endpoints"}]
  }'

الطلب الأول باستخدام Python

أرسل أول موجه باستخدام حزمة Python SDK القياسية لـ OpenAI. حدد base_url ليكون نقطة النهاية الخاصة بنا وحدد النموذج كـ "uncensored". النموذج هو متغير مفتوح المصدر (open-weight) تم ضبطه لتقليل حالات الرفض في المواضيع الموجهة للبالغين أو المثيرة للجدل. ليس إعادة تسمية لـ GPT أو Llama. يمكنك تدفق الاستجابات (stream) أو الحصول عليها دفعة واحدة.

Copyfrom openai import OpenAI

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

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

Copyimport OpenAI from "openai";

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

الاستجابات التدفقية واستخدام الرموز

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

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)

قيود حدود المعدلات وأجسام الطلبات

يُسمح لك بإرسال 300 طلب في الدقيقة لكل مفتاح. يمكنك أن يكون لديك ما يصل إلى 8 طلبات متزامنة في الوقت نفسه. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. نافذة السياق هي 100,000 رمز للجمع بين النص المطلوب والإكمال. إذا لم تضبط max_tokens، فإن الإخراج الافتراضي هو 2,048 رمز. تمنع هذه الحدود سوء الاستخدام مع ضمان أداء مستقر لتطبيقك.

معالجة الأخطاء ورموز الحالة

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