Dolphin AI API Quickstart

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

مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب. استخدم عنوان URL الأساسي https://api.dolphinaimodels.com/v1 لجميع نقاط النهاية. يتطلب النظام مفتاحًا صالحًا في Authorization الرأس. بدونها، تفشل الطلبات فورًا.

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

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

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

إليك مثال أساسي باستخدام cURL للبدء:

Copycurl https://api.dolphinaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summit elevation is 29032 feet."}]
  }'

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

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

قم بتكوين العميل بهذه القيم:

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinaimodels.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 الأساسي ومفتاح واجهة برمجة التطبيقات. يتولى مكتبة SDK عملية التسلسل تلقائيًا. يعمل هذا النهج لكل من التطبيقات التي تعمل على الخادم وتلك التي تعمل على جهاز العميل.

مثال للتكوين:

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinaimodels.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. يعيد API أحداث الإرسال عبر الخادم (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 رمز. يشمل ذلك النص الأولي والإكمال. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. تُعيد الأخطاء أكواح HTTP القياسية. يشير 401 إلى مفتاح غير صالح. يعني 402 عدم كفاية الرصيد. يشير 429 إلى تحديد معدل الطلبات.

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