البدء السريع لواجهة برمجة التطبيقات لـ Dolphin

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

يصادق مفتاح API الخاص بك على كل طلب موجه إلى نقطة النهاية الخاصة بنا. استخدم عنوان URL الأساسي HTTPS://api.apidolphin.com/v1 مع أي مكتبة SDK متوافقة مع OpenAI. معرّف النموذج هو "uncensored" لجميع الإكمالات. يضمن هذا الإعداد عمل الكود الخاص بك مع بنيتنا التحتية دون تعديل.

ندعم معلمات قياسية مثل temperature و top_p. يمكنك تمكين وضع JSON أو استدعاء الوظائف حسب الحاجة. الأخطاء والرفضات لا تستهلك رصيدك المدفوع مسبقًا. يتم شحن فقط استخدام الرموز الفعلي بأسعارنا الشفافة.

أرسل طلبك الأول

أرسل إكمال دردشة أساسي للتحقق من اتصالك. استخدم أمر curl أدناه لاختبار نقطة النهاية. استبدل YOUR_API_KEY بمفتاحك الفعلي من لوحة التحكم. تعيد الاستجابة مخرجات نص النموذج.

يستخدم هذا الطلب التنسيق القياسي لـ OpenAI. يمكنك تعديل تعليمات النظام أو رسائل المستخدم حسب الحاجة. تعيد الواجهة استجابة تحتوي على النص المُولّد. تحقق من مطابقة المخرجات لتوقعاتك قبل التوسع.

مثال للاستخدام:

Copycurl https://api.apidolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert the attached JSON payload to YAML format"}]
  }'

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

استخدم مكتبة بايثون الرسمية من OpenAI للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا. قم بتعيين عنوان URL الأساسي ومفتاح واجهة برمجة التطبيقات في تكوين العميل. يوضح مقتطف الشيفرة أدناه استدعاءً بسيطًا لتوليد النص.

ثبّت المكتبة عبر pip. ثم قم بتهيئة العميل باستخدام بيانات الاعتماد الخاصة بك. اتصل بـ chat.completions.create مع اسم النموذج "uncensored". تحافظ هذه الطريقة على قابلية نقل الكود عبر مزودي نماذج لغوية كبيرة (LLMs) المختلفين.

مثال على الكود:

Copyfrom openai import OpenAI

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

يتبع SDK لـ Node نفس نمط التكوين. قم بتهيئة عميل OpenAI بعنوان URL الأساسي والمفتاح. أرسل طلب إكمال باستخدام النموذج "uncensored". هذه الطريقة مثالية لتطبيقات الخادم.

تأكد من معالجة بيانات الاستجابة بشكل صحيح. تُعيد API كائن إكمال قياسي. يمكنك الوصول إلى النص المُولّد من كائن الاستجابة. يعمل هذا الإعداد مع Express أو Fastify أو أي إطار عمل Node.js.

مثال على التنفيذ:

Copyimport OpenAI from "openai";

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

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

تمكين التدفق لتوصيل الرمز في الوقت الفعلي. اضبط معلمة التدفق على 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)

حدود، أخطاء، ونافذة السياق

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

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