Dolphin AI API Quickstart

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

ابدأ بضبط عنوان URL الأساسي ومفتاح API في تكوين العميل الخاص بك. جميع الطلبات تُصادق عبر Authorization رأس باستخدام مفتاحك الفريد. تعمل خدمتنا كموفر مستقل لنموذج openrouter dolphin AI بديل، مما يعني أنك لا تحتاج إلى حساب على OpenRouter لاستخدام نقطة هذه النهاية. ببساطة احصل على مفتاحك من لوحة التحكم وأضفه إلى متغيرات البيئة الخاصة بك.

• URL الأساسي: https://api.openrouterdolphinai.com/v1
• رأس: Authorization: Bearer YOUR_API_KEY

يعمل هذا مع أي مكتبة SDK قياسية لـ OpenAI لأننا نحاك هيكل نقاط النهاية الخاص بها بدقة. ستتفاعل فقط مع نقطة نهاية إكمالات الدردشة، مما يبقي تكاملك بسيطًا ومركزًا على توليد النصوص.

الطلب الأول

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

استخدم أمر curl التالي لاختبار اتصالك على الفور:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

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

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

دمج بسرعة باستخدام مكتبة OpenAI Python الرسمية عن طريق توجيهها إلى عنوان URL الأساسي الخاص بنا. يتيح لك ذلك استخدام الأساليب المألوفة مثل chat.completions.create() بدون إعادة كتابة المنطق بالكامل. تتعامل المكتبة مع التسلسل تلقائيًا، لذا يمكنك التركيز على تصميم المطالبات بدلاً من تفاصيل HTTP.

قم بتكوين العميل بعنوان URL الأساسي والمفتاح:

Copyfrom openai import OpenAI

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

تذكر أن نافذة السياق الخاصة بنا هي 100,000 رمز مميز، لذا يمكنك تمرير تاريخ محادثات كبير. ستتولى مكتلة SDK الترميز النقطي والإرسال بكفاءة، مما يضمن وصول توجيهاتك إلى النموذج دون عبء زائد أو أخطاء في التنسيق.

استخدام Node SDK

يمكن لمطوري Node تحقيق نفس النتائج باستخدام openai npm package. Just like the Python version, you must override the default base URL to point to our dedicated servers. This ensures your requests go directly to the uncensored model without hitting third-party rate limits or routing delays.

قم تهيئة العميل باستخدام نقطة النهاية الصحيحة:

Copyimport OpenAI from "openai";

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

يعمل هذا النمط لكل من المكالمات المتزامنة (synchronous) وأنماط async/await. يمكنك تدفق الاستجابات أو طلب وضع JSON مباشرة ضمن استدعاء الدالة نفسه، مما يمنحك المرونة لمختلف معماريات التطبيقات دون تغيير إعداد المصادقة الأساسي.

استجابات البث

تمكين توليد النص في الوقت الفعلي عن طريق ضبط stream: true في معاملات الطلب الخاص بك. تُعيد واجهة برمجة التطبيقات تدفق أحداث مُرسلة من الخادم (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 رمز، سيتوقف التوليد، لذا اضبط max_tokens وفقًا للتحكم في التكاليف.

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