البدء السريع لواجهة برمجة التطبيقات غير الخاضعة للرقابة

الإعداد والتثبيت

قم بتكوين البيئة الخاصة بك بعنوان URL الأساسي ومفتاح API. تستخدم هذه API غير الخاضعة للرقابة المعيار /v1/chat/completions endpoint. غيّر base_url في عميل SDK الخاص بك وقدم المفتاح من لوحة التحكم.

• URL الأساسي: https://api.openrouterapipricing.com/v1
• معرف النموذج: uncensored

المصادقة تعتمد على مفتاح واحد لكل حساب. تتلقى المفتاح فوراً بعد التسجيل عبر Google أو البريد الإلكتروني. لا يلزم رقم هاتف.

Copycurl https://api.openrouterapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "get me the price per token for the largest model"}]
  }'

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

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

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

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

تمكين التدفق لتلقي الرموز في الوقت الفعلي. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين. تحتوي الحزمة الأخيرة على إجمالي استخدام الرموز للطلب.

يعمل البث مع جميع مكتبات SDK القياسية. تعامل مع أحداث التدفق لتحديث واجهة المستخدم تدريجيًا. هذا مثالي لواجهات روبوتات الدردشة.

Copyfrom openai import OpenAI

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

استدعاء الوظائف والأدوات

عرّف الأدوات في طلبك للسماح للنموذج باستدعاء الوظائف. استخدم tools معامل لتحديد المخططات. يعيد النموذج استدعاءات الأدوات عندما يكون ذلك مناسبًا.

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

Copyimport OpenAI from "openai";

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

وضع JSON

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

يحسن وضع JSON الموثوقية لمهام استخراج البيانات. يلتزم النموذج بالمخطط الذي تقدمه. استخدم هذا للحصول على تحليل متسق.

المعلمات والحدود والأخطاء

تحكّم في التوليد باستخدام temperature, top_p، و stop التسseqs. نافذة السياق هي 100,000 رمز إجمالاً. الحد الأقصى للمخرجات هو 16,000 رمز لكل طلب. الأخطاء مثل 401 (مفتاح غير صالح) أو 402 (لا رصيد) مجانية. يشير 429 إلى حدود المعدل. يتم تقييد الطلبات بـ 300 في الدقيقة. يجب أن يكون جسم الطلب أقل من 8 ميجابايت.

التدفق

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)