AR ▾
Base URL https://api.uncensoredaiapis.com/v1النموذج uncensored
احصل على مفتاح API
Uncensored AIدليل الترحيل

قم بالهجرة من OpenAI أو OpenRouter إلى واجهة ذكاء اصطناعي بدون رقابة

ابدأ عملية التحويل عن طريق تغيير عنوان URL الأساسي ومفتاح API ومعرف النموذج في عميل اختبار صغير. قم بتشغيل مجموعة محفوظة من طلباتك الخاصة قبل تحويل حركة الإنتاج: لا يعني تنسيق الطلب المتوافق بالضرورة إجابات متطابقة. يغطي هذا الدليل التكوين، والبث، واستدعاءات الأدوات، والفحوصات التي يجب تكرارها في LangChain أو LlamaIndex.

قم بالهجرة من OpenAI أو OpenRouter إلى واجهة ذكاء اصطناعي بدون رقابة

تم التحديث

نقاط رئيسية

  • غيّر ثلاث قيم فقط: عنوان URL الأساسي https://api.uncensoredaiapis.com/v1, ومفتاحك الجديد، والنموذج "uncensored".
  • إكمالات الدردشة، والبث المتدفق، واستدعاء الأدوات يعملان بتنسيق OpenAI؛ أما التضمينات (embeddings)، والصور، والصوت، والضبط الدقيق (fine-tuning) فلا توجد.
  • ضع عنوان URL الأساسي والمفتاح والنموذج في متغيرات البيئة بحيث تعمل الخلفيات القديمة والجديدة جنبًا إلى جنب، ويكون التراجع مجرد تبديل ملف.
  • عيّن max_tokens صراحةً وخطط لنافذة السياق ذات الـ 100,000 رمز قبل إجراء التبديل.

ما الذي يتغير عند التبديل

إذا كان تطبيقك يتواصل بالفعل مع واجهة برمجة التطبيقات لإكمال المحادثات من OpenAI أو OpenRouter، فإن الانتقال إلى واجهة برمجة التطبيقات هذه للذكاء الاصطناعي بدون رقابة هو تغيير في التكوين وليس إعادة كتابة. تتغير ثلاث قيم ويظل كل شيء آخر في رمز الطلب كما هو: عنوان URL الأساسي، ومفتاح API، واسم النموذج.

الإعدادقبلبعد
عنوان URL الأساسيعنوان URL الخاص بـ OpenAI أو OpenRouterhttps://api.uncensoredaiapis.com/v1
المصادقةمفتاح من خدمتك الحاليةمفتاح من حسابك هنا، يُرسل بصيغة Authorization: Bearer <key>
النموذجمعرف نموذج مثل اسم نموذج GPT أو نموذج مُوجّهuncensored
نقطة النهاية/chat/completionsنفس الشيء: POST /v1/chat/completions

يوجد نموذج واحد فقط، لذا لا توجد قائمة نماذج للاختيار من بينها. يوجد GET /v1/models الذي يسردها، مما يبقي مساعدي SDK وفحوصات الحالة التي تستدعيها تعمل. الرسائل، والبث المتدفق، واستدعاء الأدوات تستخدم نفس تنسيقات OpenAI التي ترسلها بالفعل. هذه الصفحة دليل عملي؛ إذا كنت تريد مقارنة التكلفة، وزمن الاستجابة، والخصوصية مع OpenRouter، فاقرأ بدلاً من ذلك مقال نماذج OpenRouter بدون رقابة.

إليك فرق Python الأدنى. لا يتغير شيء آخر في الاستدعاء.

import os
from openai import OpenAI

# before
# client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
# model = "gpt-4o"

# after
client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)
model = "uncensored"

resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)
print(resp.choices[0].message.content)

بالنسبة لمستخدمي OpenRouter، ينطبق نفس الشيء: استبدل عنوان URL الأساسي ومفتاح OpenRouter، وأزل أي إضافات خاصة بالتوجيه التي مررتها في الرؤوس أو جسم الطلب (انظر جدول التوافق أدناه).

توافق المعلمة والميزة

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

البندالرمزملاحظات
modelمدعوماستخدم uncensored. نموذج واحد فقط.
messages (أدوار النظام، المستخدم، المساعد، الأداة)مدعومتنسيق رسالة OpenAI القياسي. نافذة السياق هي 100,000 رمز للموجّه بالإضافة إلى الإكمال.
max_tokensمدعومحتى نهاية نافذة الـ 100,000 رمز.
stream: trueمدعومالأحداث المرسلة من الخادم. يُضاف جزء الاستخدام النهائي تلقائيًا.
tools، tool_choice، الرسائل ذات الدور toolمدعومصيغة استدعاء الدوال من OpenAI.
خيارات العينة والتوقف (temperature، top_p، stop، وما شابه)مدعومحقول OpenAI القياسية، تُمرر كما هي. أعد ضبط temperature بعد التبديل: قد يبدو نفس القيمة مختلفة على نموذج جديد.
إضافات التوجيه: قوائم النماذج الاحتياطية، تفضيلات التوجيه، رؤوس نسب التطبيقغير متوفريوجد نموذج واحد فقط، لذا لا يوجد شيء للتوجيه بينه. أزل هذه من الطلبات والإعدادات.
التضميناتغير متوفراحتفظ بمصدر تضمينات منفصل لخط أنابيب RAG.
توليد الصور، الرؤية، الصوت، الفيديوغير متوفرالواجهة البرمجية للنصوص فقط.
ضبط دقيقغير متوفرلا توجد نقاط نهاية للضبط الدقيق. شكّل السلوك باستخدام توجيهات النظام.

النتيجة العملية هي أن خط الأنابيب الذي يستخدم التضمينات للاسترجاع يحتاج إلى عميلين: واحد لخدمة التضمينات الحالية الخاصة بك، وواحد للتوليد هنا. هذا انقسام طبيعي، ونهج متغير البيئة في القسم التالي يحافظ على ترتيبه.

تشغيل الاثنين جنبًا إلى جنب مع متغيرات البيئة

يضمن الترحيل الآمن بقاء كلا الخلفيتين نشطين واختيار واحد عند التشغيل. ضع القيم الثلاث المختلفة في متغيرات البيئة، واقرأها من مكان واحد. ثم يمكنك توجيه بيئة التطوير، أو نسبة من حركة المرور، أو ميزة واحدة إلى الواجهة البرمجية الجديدة دون تفرع رمز الطلب.

# .env.openai
LLM_BASE_URL=your-current-base-url
LLM_API_KEY=paste-your-existing-key
LLM_MODEL=gpt-4o

# .env.uncensored
LLM_BASE_URL=https://api.uncensoredaiapis.com/v1
LLM_API_KEY=paste-your-key-here
LLM_MODEL=uncensored

ثم يبني مصنع واحد العميل:

import os
from openai import OpenAI

def make_client() -> tuple[OpenAI, str]:
    client = OpenAI(
        base_url=os.environ["LLM_BASE_URL"],
        api_key=os.environ["LLM_API_KEY"],
    )
    return client, os.environ["LLM_MODEL"]

client, model = make_client()
resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(model, "->", resp.choices[0].message.content)

نفس النمط في Node.js:

import OpenAI from "openai";

export function makeClient() {
  const client = new OpenAI({
    baseURL: process.env.LLM_BASE_URL,
    apiKey: process.env.LLM_API_KEY,
  });
  return { client, model: process.env.LLM_MODEL };
}

const { client, model } = makeClient();
const resp = await client.chat.completions.create({
  model,
  messages: [{ role: "user", content: "Reply with the single word: ready" }],
  max_tokens: 10,
});
console.log(model, "->", resp.choices[0].message.content);

لمقارنة السلوك، شغّل مجموعة الموجّهات نفسها على كلا الإعدادين، على سبيل المثال باستخدام set -a; source .env.uncensored; set +a قبل أمر الاختبار الخاص بك. نظرًا لأن أسماء المتغيرات عامة، فلا حاجة لتغيير الكود عندما تقوم أخيرًا بإيقاف الخدمة للخادم الخلفي القديم، والتراجع خطوة للوراء هو مجرد تبديل ملف.

LangChain و LlamaIndex وعملاء متوافقين مع OpenAI

أي إطار عمل يتيح لك تجاوز عنوان URL الأساسي لـ OpenAI سيعمل مع واجهة برمجة التطبيقات هذه، لأن عقد HTTP هو نفسه. تمرر عنوان URL الأساسي، والمفتاح، واسم النموذج؛ يقوم الإطار بالعمل الآخر. بالنسبة لـ LangChain، يوفر الحزمة langchain_openai ChatOpenAI:

import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
    model="uncensored",
    max_tokens=500,
)

print(llm.invoke("Give me a one-line pitch for a noir detective game.").content)

بالنسبة لـ LlamaIndex، استخدم صنف LLM المتوافق مع OpenAI من حزمة llama-index-llms-openai-like، المخصصة للخوادم التي تطبق تنسيق إكمالات الدردشة ولكن ليست OpenAI نفسها:

import os
from llama_index.llms.openai_like import OpenAILike

llm = OpenAILike(
    api_base="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
    model="uncensored",
    is_chat_model=True,
)

print(llm.complete("Give me a one-line pitch for a noir detective game."))

شيئان يجب تذكرهما في إعدادات الإطار. أولاً، ميزات الاسترجاع التي تستدعي نموذج التضمين ستحتاج إلى مصدر تضمين مختلف، لأن هذا الـ API لا يوفره. ثانياً، أحياناً تفترض الأطر اسم نموذج من قائمة داخلية لتحديد حجم نافذة السياق أو دعم الدوال؛ إذا رأيت تحذيراً حول نموذج غير معروف، فهذا تجميلي، لكن تحقق من أن نافذة السياق التي يفترضها إطارك لا تتجاوز 100,000 رمز. تختلف أسماء المعلمات قليلاً بين المكتبات (base_url، api_base، baseURL)، لذا تحقق من الاسم الذي تستخدمه مكتبتك. تتبع الأدوات الأخرى التي تقبل عنوان URL أساسي مخصص لـ OpenAI، مثل إضافات المحررات وواجهات الدردشة، نفس نمط القيم الثلاث.

قائمة فحص الاختبار قبل التبديل

قم بالمرور على هذه القائمة في بيئة الاختبار. كل عنصر سريع، ومعاً يلتقط معظم مفاجآت الترحيل.

  1. المصادقة والتوجيه. اتصل بـ GET /v1/models باستخدام مفتاحك. تعني 401 أن المفتاح أو الرأس خاطئ؛ تعني 404 أن المسار خاطئ.
  2. الإكمال الأساسي. أرسل موجّه سطر واحد مع تعيين max_tokens وتأكد من وجود choices[0].message.content و usage.
  3. البث المتدفق. شغّل مسار واجهة المستخدم الحقيقية مع stream: true. تأكد من أن المفسر يتحمل قطعة الاستخدام النهائية مع قائمة choices فارغة.
  4. استدعاء الأدوات. نفذ مكالمة كاملة: طلب، tool_calls، دور tool للرد، إجابة نهائية. تحقق من أن الكود الخاص بك يتعامل مع الردود التي لا تحتوي على استدعاء أداة.
  5. الموجّهات الطويلة. أرسل موجّهاً قريباً من الحد الأقصى الحقيقي. الموجّه الأطول من 100,000 رمز يعيد 400، بينما يُقتطع max_tokens تلقائيًا ليناسب النافذة.
  6. معالجة الأخطاء. شابه مفتاحاً خاطئاً (401). أكد أن التطبيق الخاص بك يقرأ JSON error.code ويتعامل مع 402 no_credit، 403 content_blocked، 429 و 503 upstream_busy بشكل معقول.
  7. جودة المخرجات والنبرة. أعد تشغيل عينة من الموجّهات الحقيقية وقارن الردود مع النموذج الحالي. الموجّهات التي تم ضبطها حول رفض أو تحفظ نموذج آخر قد تحتاج إلى تبسيط.
  8. تتبع التكلفة. سجّل usage. المدخلات $0.15 لكل مليون رمز والمخرجات $0.50 لكل مليون، لذا فإن تقديراتك من عدادات الرموز الحالية سهلة إعادة حسابها.

للنسخ القابلة للتشغيل من خطوات البث المتدفق، والأدوات، وإعادة المحاولة، انظر إلى صفحة أمثلة الكود.

المزالق الشائعة

ترك اسم النموذج القديم في مكانه. الفشل الأكثر تكراراً هو طلب لا يزال يقول معرف نموذج آخر. اقرأ النموذج من التكوين، كما في مثال متغير البيئة، حتى يتحرك مع عنوان URL الأساسي.

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

غياب /v1 في عنوان URL الأساسي. يجب أن ينتهي عنوان URL الأساسي بـ /v1. تضيف المكتبات /chat/completions نفسها؛ ينتج عنوان URL الأساسي بدون اللاحقة أخطاء 404.

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

تجاهل حد المخرجات. إذا لم تقم بتعيين max_tokens، فقد يمتد الرد إلى نهاية نافذة السياق. إذا كانت خدمة أخرى تمنحك ردوداً أطول افتراضياً، فقم بتعيين القيمة صراحةً، لأن الحد الصغير قد ينهي الردود مبكراً مع finish_reason: length.

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

إعادة المحاولة لكل شيء. أعد المحاولة مع 429 و 503 فقط. تعني 402 أن الرصيد مستنفد أو انتهت التجربة المجانية، وإعادة المحاولة لن تساعد. قم بشحن الرصيد واستمر، كما هو موضح في صفحة التسعير.

قواعد المحتوى. لا يتم رفض المحتوى البالغ القانوني والخيال، لكن المحتوى الجنسي الذي يتضمن قاصرين يتم حظره دائماً بخطأ 403، بما في ذلك في الخيال ولعب الأدوار. الخدمة للبالغين والاستخدام القانوني، لذا تأكد من أن منتجك الخاص يفرض حجب العمر حيثما كان ذلك ذا صلة.

أسئلة وأجوبة

هل يجب أن أعيد كتابة الكود الخاص بي للتبديل من OpenAI؟

عادة لا. غيّر base_url و api_key واسم النموذج إلى uncensored في إعدادات العميل الخاص بك. يتبع تنسيق الرسائل والبث المتدفق واستدعاء الدوال نفس تنسيق OpenAI.

هل يمكنني الاستمرار في استخدام OpenRouter جنبًا إلى جنب مع هذه الـ API؟

نعم. اقرأ عنوان الـ API الأساسي والمفتاح والنموذج من متغيرات البيئة، ثم وجّه كل بيئة أو ميزة إلى الخلفية التي تريدها. يمكن تشغيل الاثنين بالتزامن أثناء الترحيل التدريجي.

ماذا يحدث لطلبات تضمين النصوص أو الصور؟

لن تعمل هنا. الـ API مخصص للنصوص فقط، ولا يدعم التضمين أو الصور أو الصوت أو الفيديو أو ضبط النماذج، لذا احتفظ بمصدر منفصل لتلك الميزات.

هل يعمل LangChain مع هذا الـ API للذكاء الاصطناعي بدون رقابة؟

نعم. استخدم ChatOpenAI من langchain_openai مع تعيين base_url إلى https://api.uncensoredaiapis.com/v1, ومفتاحك و model="uncensored". يتبع أي عميل يقبل base URL مخصصًا من OpenAI نفس النمط.

مفتاحك على بُعد نموذج واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.