البدء السريع في واجهة برمجة التطبيقات: إكمال الدردشة

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

مفتاح واجهة برمجة التطبيقات الخاص بك يصادق على كل طلب. استخدم Authorization رأس مع Bearer scheme. عنوان URL الأساسي الخاص بك هو https://api.nsfwopenrouter.com/v1. يعمل هذا الرابط مع أي مكتبة SDK متوافقة مع OpenAI. لا تحتاج إلى اشتراك. تدفع فقط مقابل الرموز المستخدمة. لا تتكبّد تكاليف الأخطاء أو الرفض. سجّل عبر Google أو البريد الإلكتروني للحصول على مفتاحك فورًا.

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

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

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

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

تكوين معلمات النموذج

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

فرض وضع JSON

استخدام response_format مع {"type": "json_object"}. يضمن النموذج إخراج JSON صحيح. هذا الهيكل ضروري للتكامل البرمجي. حلل الاستجابة مباشرة في كائنات تطبيقك. تجنب تحليل التعبيرات النمطية للموثوقية. يضمن هذه الميزة استخراج بيانات متسق. تعمل بسلاسة مع مكتبات SDK القياسية.

فهم استدعاءات الأدوات

عرّف الأدوات في جسم الطلب. يمكن للنموذج إرجاع استدعاءات دوال مهيكلة. استخدم tool_choice لإجبار سلوكيات محددة. هذا يمكّن عمليات عمل الوكلاء الديناميكية. تدعم واجهة برمجة التطبيقات تنسيقات الأدوات القياسية لـ OpenAI. حلل tool_calls مصفوفة في الاستجابة. نفذ الدوال وأعد تغذية النتائج. هذا يتيح تفاعلات متعددة الخطوات معقدة.

cURL

Copycurl https://api.nsfwopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run my unit tests and show results"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

التدفق

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)