دليل البدء السريع لـ API لـ OpenRouter dolphin

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

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

Copycurl https://api.openrouterdolphin.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 libraries for Python web scraping."}]
  }'

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

نقطة النهاية: POST /v1/chat/completions

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

Copyfrom openai import OpenAI

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

تُعيد الـ API كائن JSON قياسي يحتوي على النص المولد. لا تدعم التضمينات (embeddings) أو الصور أو الصوت. ركز على سير عمل توليد النصوص. يستجيب النموذج للطلبات دون تصفية المحتوى البالغ القانوني أو المثير للجدل.

نقطة النهاية: GET /v1/models

استرجع النماذج المتاحة عبر طلب GET بسيط. تؤكد نقطة النهاية هذه معرف النموذج الذي يجب عليك استخدامه.

Copyimport OpenAI from "openai";

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

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

بيانات التدفق والاستخدام

فعّل البث عن طريق تعيين 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)

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

المعلمات: درجة الحرارة وTop P والأدوات

تحكّم في سلوك التوليد باستخدام المعاملات القياسية. اضبط temperature للعشوائية و top_p للعينة النواة. مكن استدعاء الوظائف عن طريق توفير tools مصفوفة.

استخدام response_format مع {"type": "json_object"} لإخراج JSON صارم. يمكنك أيضًا تعيين seed لضمان إمكانية إعادة الإنتاج. تدعم واجهة برمجة التطبيقات presence_penalty و frequency_penalty لضبط استخدام الكلمات. تعمل هذه المعاملات تماماً كما تفعل في عملاء OpenAI القياسيين.

حدود المعدلات وحجم الطلب

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

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