توثيق واجهة برمجة التطبيقات لـ Dolphin ai

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

مفاتيح API مصادقة طلباتك المدفوعة مسبقاً فوراً. تتلقى مفتاحاً نشطاً واحداً لكل حساب، يستبدل أي مفتاح سابق عند إنشائه. يشير عنوان URL الأساسي إلى الخدمة المستضافة.

• عنوان URL الأساسي: HTTPS://api.aidolphin.cc/v1
• رأس: المصادقة: حامل YOUR_API_KEY

Copycurl https://api.aidolphin.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five open source inference engines"}]
  }'

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

أرسل حمولات JSON القياسية إلى نقطة نهاية إكمال الدردشة. معرف النموذج هو دائمًا "uncensored" للحصول على مخرجات نصية متسقة. تكلف الرموز المدخلة $0.15 لكل مليون، بينما تكلف الرموز المخرجة $0.50 لكل مليون.

• النموذج: uncensored
• الإخراج الأقصى: 16,000 رمز

Copyfrom openai import OpenAI

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

استجابات التدفق عبر أحداث الإرسال عبر الخادم (SSE)

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد الـ API البيانات عبر أحداث الإرسال من الخادم (SSE) لتسليم الرموز في الوقت الفعلي. تظهر تفاصيل استخدام الرمز في الشريحة الأخيرة من التدفق.

Copyimport OpenAI from "openai";

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

فرض وضع JSON للبيانات المهيكلة

استخدام response_format تعيين إلى {"type": "json_object"} لإجبار إخراج منظم. يضمن ذلك أن يُرجع النموذج JSON صالحًا بدون تنسيق ماركداون إضافي. يعتمد استدعاء الأدوات وتعريفات الأدوات أيضًا على هذا الهيكل JSON.

تكوين درجة الحرارة، top_p، وسلاسل التوقف

اضبط معلمات أخذ العينات للتحكم في العشوائية وطول المخرجات. اضبط temperature للإبداع، top_p للعينة النواة، و stop التسseqs لتقطيع المخرجات مبكرًا. تساعد عقوبات الحضور والتكرار في تقليل العبارات المتكررة.

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)

فهم حدود المعدلات والحصص

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