محدّث
عنوان واجهة برمجة التطبيقات المتوافقة مع OpenAI: عنوان الأساس والرؤوس
عنوان الأساس هو https://api.chinesellmapi.com/v1. ضعه حيث يتوقع عميل OpenAI عنوان أساس، وأضف مفتاحك كرمز Bearer، واستخدم معرف النموذج uncensored.

الإجابة المختصرة
إذا كنت تبحث عن عنوان واجهة برمجة تطبيقات متوافق مع OpenAI لهذه الخدمة، انسخ هذه القيمة:
https://api.chinesellmapi.com/v1
هذا هو عنوان URL الأساسي. كل مكتبة SDK متوافقة مع OpenAI، وعميل سطح المكتب، وإطار عمل للوكلاء يحتوي على حقل يُسمّى "base URL" أو "API base" أو "endpoint" أو "host" يقبل هذه السلسلة النصية. يوضع المفتاح في حقل "API key" المطابق، واسم النموذج هو uncensored.
توجد نقطتا نهاية خلفه: POST /v1/chat/completions للدردشة، وGET /v1/models لسرد النماذج. لا يُقدّم أي شيء آخر من واجهة OpenAI، لذا لا توجد طريقة للتعامل مع النصوص التمثيلية (embeddings)، ولا طريقة للصور، ولا طريقة للضبط الدقيق (fine-tuning). إذا كنت بحاجة إلى مفتاح أولاً، فإن صفحة مفتاح API ترشدك خلال عملية التسجيل.
عنوان URL الأساسي مقابل عنوان URL لنقطة النهاية الكاملة
تحدث معظم الأخطاء هنا. تنقسم العملاء إلى فئتين: تلك التي تريد عنوان URL الأساسي وتضيف المسار بنفسها، وتلك التي تريد عنوان URL الكامل للمكالمة. يعرض الجدول الشكلين.
| ما يطلبه الحقل | القيمة التي تُدخلها |
|---|---|
| عنوان URL الأساسي، API base، مضيف OpenAI | https://api.chinesellmapi.com/v1 |
| عنوان URL الكامل لإكمال الدردشة | https://api.chinesellmapi.com/v1/chat/completions |
| عنوان URL لسرد النماذج | https://api.chinesellmapi.com/v1/models |
تنتمي مكتبات OpenAI SDK الرسمية، وغلاف OpenAI في LangChain، وLiteLLM، ومعظم واجهات الدردشة الأمامية إلى المجموعة الأولى. الأدوات التي تتيح لك لصق عنوان URL لطلب خام تنتمي إلى المجموعة الثانية. عندما لا يوضح ملصق الحقل أيهما، اقرأ النص التوضيحي (placeholder): إذا أظهر شيئًا ينتهي بـ /v1، فإنه يريد عنوان URL الأساسي.
شرطات النهاية
تتعامل معظم مكتبات SDK مع شرطة النهاية، لكن بعضها يبني المسار النهائي عن طريق دمج النصوص حرفيًا. إذا حصلت على خطأ 404 وكان عنوان URL ينتهي بـ /v1/، احذف شرطة النهاية الأخيرة وحاول مرة أخرى.
رؤوس الطلبات التي تتوقعها واجهة API
تحتاج الطلبات إلى رأس واحد للمصادقة ورأس واحد لنوع الجسم:
Authorization: Bearer YOUR_KEYContent-Type: application/json
تضبط مكتبات SDK كلاهما لك. إذا بنيت الطلبات يدويًا، إليك أصغر مكالمة تعمل:
curl https://api.chinesellmapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in one sentence."}]
}'
يحمل الرد بعض الرؤوس التي تستحق تسجيلها: X-Request-Id لأسئلة الدعم، وX-Balance-USD للرصيد المتبقي، وX-RateLimit-Limit-Requests وX-RateLimit-Limit-Concurrency للحدود التي تنطبق على مفتاحك.
إعدادها في مكتبات OpenAI SDK
تتغير قيمتان فقط مقارنةً بإعداد OpenAI القياسي: عنوان URL الأساسي والمفتاح. يبقى كل شيء آخر في الكود كما هو.
Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Translate 'good morning' into Chinese."}],
)
print(resp.choices[0].message.content)
Node
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.chinesellmapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Translate 'good morning' into Chinese." }],
});
console.log(resp.choices[0].message.content);
يعمل البث المتدفق بنفس الطريقة: أضف stream: true واقرأ الأجزاء (chunks). تصل أرقام الاستخدام في نهاية البث. ضع في اعتبارك أن الطلب المتدفق يحتل أحد فتحات التزامن الخاصة بك حتى إغلاق البث.
متغيرات البيئة بدلاً من الكود
تقرأ مكتبات OpenAI الحالية لـ Python وNode.js المتغيرات OPENAI_BASE_URL وOPENAI_API_KEY من البيئة عندما لا تمررها في الكود. هذه هي أسرع طريقة لتوجيه مشروع موجود إلى نقطة نهاية جديدة دون لمس سطر:
export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py
تستخدم العديد من الأدوات من جهات خارجية نفس اسمَي المتغيرين، رغم أن بعضها يستخدم متغيراته الخاصة، مثل API_BASE أو OPENAI_API_BASE في المشاريع القديمة. تحقق من وثائق الأداة لمعرفة الاسم الدقيق. إذا كان المشروع يربط قيمة api.openai.com بشكل ثابت في مكان ما، ابحث في الشيفرة المصدرية عن اسم المضيف هذا واستبدله.
يوجد اسم النموذج عادةً في إعداد منفصل، لذا تذكر تغييره إلى uncensored أيضاً. ترك اسم نموذج OpenAI الافتراضي هو السبب الثاني الأكثر شيوعاً للخطأ بعد وجود خطأ في عنوان URL.
تحقق من الاتصال قبل تصحيح أخطاء التطبيق
اختبر عنوان URL والمفتاح باستخدام طلب لا يكلف شيئاً. سرد النماذج لا يستهلك رموزاً:
curl https://api.chinesellmapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
إذا أرجع هذا قائمة JSON تتضمن uncensored، فإن عنوان URL والمفتاح صحيحان، وأي مشكلة متبقية تكمن في إعدادات العميل. إذا فشل الطلب، استخدم هذا الجدول.
| العرض | السبب المحتمل | الحل |
|---|---|---|
| 404 غير موجود | تضاعف المسار (/v1/v1/...) أو غياب /v1 | أدخل عنوان URL الأساسي مرة واحدة فقط، بحيث ينتهي بـ /v1 |
| 401 غير مصرح | المفتاح مفقود، أو تم نسخه مع مسافة، أو أُرسل في رأس غير صحيح | أرسل Authorization: Bearer YOUR_KEY وأعد نسخ المفتاح |
خطأ 429 مع الرمز rate_limited | طلبات كثيرة جداً في الدقيقة | أبطئ أو قم بترتيب الطلبات في طابور |
429 مع رمز concurrency | طلبات كثيرة جداً في نفس اللحظة | حدّ الطلبات المتزامنة، تذكر أن البث المتدفق يشغل خانة |
429 مع Retry-After: 5 | حمل زائد مؤقت | انتظر خمس ثوانٍ وأعد المحاولة |
| النموذج غير موجود | اسم نموذج OpenAI المتبقي | اضبط النموذج على uncensored |
حدود يجب أن تعرفها قبل توجيه الإنتاج إليها
يسمح المفتاح الكامل بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 طلب متزامن و60 في الدقيقة. يمكن أن يصل جسم الطلب إلى 8 ميجابايت، ونافذة السياق هي 100,000 رمز، الموجّه والإكمال معًا، لذا فإن max_tokens اختياري.
الخدمة مخصصة للنصوص فقط وتشغل نموذجاً مفتوح الأوزان من مزود مستقل. إنها ليست واجهة برمجة التطبيقات الرسمية لأي بائع نماذج، وهي لا تعيد التوجيه بين المزودين. إذا كان تطبيقك منتجاً باللغة الصينية، فإن دليل البدء السريع لتطبيق اللغة الصينية يوضح كيفية هيكلة الموجّهات، ويغطي دليل واجهة برمجة التطبيقات للترجمة القواميس والعناصر النائبة.
الفوترة هي الدفع حسب الاستخدام من رصيد مسبق الدفع: $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. الطلبات الفاشلة أو المرفوضة لا تُحسب. صفحة التسعير توضح أحجام الشحن والمكافآت، ويمكن للمستخدمين الجدد المطالبة بـ $0.50 من رصيد تجريبي بنقرة واحدة على صفحة المفتاح، ساري لمدة 7 أيام وبدون بطاقة. لمزيد من التوجيه حول إعداد العميل، راجع مستندات البدء السريع.
المحتوى الذي يُجنّس القاصرين غير مسموح به مطلقاً؛ وبجانب ذلك، النموذج مضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين.
أماكن أخرى يذهب إليها عنوان URL
تعطي الأطر المختلفة اسماً مختلفاً للحقل، لكن القيمة هي نفسها. ثلاثة أمثلة شائعة:
# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
model="uncensored",
)
# LiteLLM
import litellm
r = litellm.completion(
model="openai/uncensored",
api_base="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
messages=[{"role": "user", "content": "ping"}],
)
في LiteLLM، تحدد اللاحقة openai/ للمكتبة استخدام تنسيق OpenAI السلكي ضد عنوان URL الأساسي الخاص بك، والجزء بعد الشرطة المائلة هو معرف النموذج. واجهات الدردشة الأمامية مثل SillyTavern لها مصدر "متوافق مع OpenAI" يحتوي على ثلاثة حقول: URL، المفتاح والنموذج. نفس القيم الثلاث مرة أخرى.
أبقِ المفتاح بعيداً عن المتصفح
لا تستدعِ API من واجهة JavaScript الأمامية التي تُوزع للزوار. يمكن لأي شخص قراءة المفتاح من الصفحة وإنفاق رصيدك. ضع مسار خادم صغير في المنتصف، واحفظ المفتاح في متغير بيئة هناك، واسمح لموقعك باستدعاء هذا المسار.
التبديل بين نقاط النهاية دون تغييرات في الكود
إذا كنت تختبر عدة مزودين، ضع القيم الثلاث في ملف الإعدادات بدلاً من الكود المصدري. كتلة إعدادات صغيرة تؤدي الغرض وتجعل عنوان URL هو الشيء الوحيد الذي تحتاج إلى تعديله:
import os
from openai import OpenAI
client = OpenAI(
base_url=os.getenv("LLM_BASE_URL", "https://api.chinesellmapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.getenv("LLM_MODEL", "uncensored")
هذا أيضاً يسهل فصل بيئتي الاختبار والإنتاج: استخدم مفتاحاً مختلفاً لكل بيئة، وسيُظهر رأس الاستجابة X-Balance-USD رصيد كل مفتاح المتبقي.
المزيد من الأدلة
أسئلة وأجوبة
هل أدرج /chat/completions في عنوان URL الأساسي؟
لا. أدخل https://api.chinesellmapi.com/v1 واسمح للمكتبة بإضافة /chat/completions. فقط الأدوات التي تطلب عنوان URL لطلب كامل تحتاج إلى الصيغة الأطول.
هل يمكنني استخدام عنوان URL نفسه لعدة تطبيقات؟
نعم. يمكن أن يذهب عنوان URL والمفتاح إلى أي عدد من العملاء. هم يشاركون حدود مفتاحك: 8 طلبات متزامنة و300 طلب في الدقيقة على مفتاح كامل.
ما اسم النموذج الذي أدخله؟
استخدم uncensored. يمكنك تأكيد ذلك باستدعاء GET /v1/models بالمفتاح الخاص بك.
هل هذا هو API الرسمي لبائع على غرار OpenAI؟
لا. إنه API مستضاف لنموذج مفتوح الأوزان يعمل بواسطة مزود مستقل، ومبني ليكون متوافقاً مع تنسيق طلب OpenAI.
كيف أختبر المفتاح دون إنفاق الرصيد؟
استدعِ GET /v1/models برأس Authorization. يعيد قائمة النماذج ولا يستخدم الرموز.
مفتاحك على بُعد استمارة واحدة
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذا هو الإعداد كله.