إذا كانت أداتك تتحدث بصيغة OpenAI Chat Completions، يمكنك عادةً توجيهها إلى أي Base URL متوافق. هذا الدليل يشرح ثلاث إعدادات شائعة — Cursor وContinue وOpen WebUI — باستخدام بوابة N3mak AI Gateway العامة.
لا حاجة لطقوس معقّدة: Base URL + مفتاح Bearer + معرّف موديل. ما يلي هو ما تقبله البوابة فعليًا اليوم.
ما تحتاجه
| Base URL | https://n3mak-gateway.n3mak.workers.dev/v1 |
| مفتاح API | يبدأ بـ n3k_ (في الأمثلة استخدم n3k_YOUR_KEY — لا تلصق مفتاحًا حيًا في التوثيق أو git) |
| الموديل الافتراضي | gpt-oss-20b |
| المصادقة | Authorization: Bearer n3k_YOUR_KEY |
المسارات بأسلوب OpenAI تشمل:
-
GET /v1/models(يتطلب مفتاح Bearer صالحًا) -
POST /v1/chat/completions(بدون بث وبث SSE بسيط)
إذا حذفت model، يستخدم العامل gpt-oss-20b افتراضيًا.
الموديلات حسب الخطة (المعرّفات العامة الدقيقة)
| الخطة | معرّفات الموديل المسموحة |
|---|---|
| التجربة (Trial) | gpt-oss-20b |
| Pioneer (3$) |
gpt-oss-20b، llama-3.1-8b
|
| Starter (9$) | قائمة Pioneer + gpt-oss-120b، mistral-small-3.1-24b، qwen2.5-coder-32b
|
| Pro (49$) | كل ما سبق + llama-3.3-70b
|
استخدم المعرّفات القصيرة أعلاه داخل العملاء. فضّلها على الأسماء ذات البادئات.
ملاحظة تسويق: نركّز يوميًا على التجربة المجانية وPioneer. الخطط الأعلى موجودة في العامل؛ روّج لها فقط عندما تحتاج قائمة موديلاتها أو حدودها.
اختبار سريع (curl)
استبدل العنصر النائب محليًا — لا ترفع مفتاحًا حقيقيًا.
curl https://n3mak-gateway.n3mak.workers.dev/v1/chat/completions \
-H "Authorization: Bearer n3k_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-oss-20b",
"messages": [{"role": "user", "content": "Hello from N3mak"}]
}'
اكتشاف اختياري:
curl https://n3mak-gateway.n3mak.workers.dev/v1/models \
-H "Authorization: Bearer n3k_YOUR_KEY"
1) Cursor
- افتح Cursor Settings → Models (macOS:
Cmd+Shift+J/ Windows وLinux:Ctrl+Shift+J). - في OpenAI API Key الصق
n3k_YOUR_KEY. - فعّل Override OpenAI Base URL.
- الصق العنوان حرفيًا:
https://n3mak-gateway.n3mak.workers.dev/v1
أبقِ /v1. لا تُلحق /chat/completions.
- أضف موديلًا مخصصًا:
gpt-oss-20b(مفاتيح Pioneer قد تستخدم أيضًاllama-3.1-8b.) - اختر الموديل في Chat أو Agent المحلي وأرسل رسالة اختبار قصيرة.
تنبيهات Cursor
- Override عام لحركة OpenAI-family أثناء تفعيله. قد تُوجَّه موديلات Cursor المدارة أيضًا إلى Base URL المخصص. أطفئ Override عندما تريد موديلات اشتراك Cursor مرة أخرى.
- مفتاحك / البوابة المخصصة ينطبقان على Chat وAgent المحليين فقط. لا يغطيان Cursor Tab أو Auto أو Cloud/Background Agents أو Automations أو Cursor CLI أو Cursor API/SDK.
2) Continue
عدّل ~/.continue/config.yaml (أو إعداد المشروع):
name: N3mak
version: 0.0.1
schema: v1
models:
- name: N3mak gpt-oss-20b
provider: openai
model: gpt-oss-20b
apiBase: https://n3mak-gateway.n3mak.workers.dev/v1
apiKey: n3k_YOUR_KEY
أعد تحميل Continue / أعد تشغيل إضافة بيئة التطوير، ثم اختر N3mak gpt-oss-20b.
تنبيهات Continue
- اجعل
apiBaseينتهي بـ/v1. - عامل N3mak يعرض chat completions. أبقِ
modelضمن قائمة خطتك. إذا حاول العميل مسار Responses وحدث خلل، توثيق Continue يذكرuseResponsesApi: falseلإجبار/chat/completions— استخدمه فقط عند الحاجة.
3) Open WebUI
- Open WebUI → Settings → Admin → Connections.
- ضمن Manage OpenAI API Connections اضغط ➕ Add Connection.
-
URL / Base URL:
https://n3mak-gateway.n3mak.workers.dev/v1 -
API Key:
n3k_YOUR_KEY - Provider (Advanced): اتركه Default (OpenAI-compatible عادي).
- اضغط Verify Connection (يستدعي
GET /v1/models). إذا فشل التحقق وعملت الدردشة، أضف معرّفات الموديل يدويًا (gpt-oss-20bوأي موديلات مسموحة في خطتك). - Save ثم اختر الموديل في الدردشة.
بديل عبر المتغيرات البيئية:
OPENAI_API_BASE_URL=https://n3mak-gateway.n3mak.workers.dev/v1
OPENAI_API_KEY=n3k_YOUR_KEY
تنبيهات Open WebUI
- للدردشة يلزم
POST /v1/chat/completions.GET /v1/modelsمفيد للاكتشاف. - مسارات Embeddings / TTS / الصور غير مفترضة هنا — الدليل يغطي الدردشة فقط.
- استخدم
…/v1حرفيًا.
استكشاف الأخطاء
| العرض | السبب المحتمل |
|---|---|
model_not_found |
خطأ إملائي — استخدم المعرّفات الدقيقة من الجدول |
model_not_allowed / 403 |
الموديل ليس ضمن قائمة خطتك |
| 401 | مفتاح Bearer n3k_… ناقص أو خاطئ |
| Cursor «يعمل» لكن موديلات الاشتراك تتعطل | Override OpenAI Base URL ما زال مفعّلًا — أطفئه عند عدم استخدام البوابة المخصصة |
الأمان
- لا ترفع مفاتيح
n3k_الحقيقية إلى git أو اللقطات أو المنشورات العامة. - إن تسرب مفتاح، بدّله عبر مسار البوت / الدعم.
جرّب مجانًا (بدون بطاقة)
تريد مفتاحًا قبل الشراء؟
اكتب /trial في @N3mak_bot.
- 24 ساعة
- 20 طلبًا/يوم (وأيضًا 5 طلبات/دقيقة)
- الموديل:
gpt-oss-20bفقط - بدون بطاقة — لا دفع Whop في مسار التجربة
بعد التجربة، Pioneer (3$) يستخدم نفس أسلوب البوابة؛ مفاتيح الدفع تصل عبر @N3mak_bot خلال ساعات قليلة بعد الدفع على Whop (ليست فورية). المتجر: n3mak-buy.vercel.app · Pioneer: whop.com/checkout/plan_n2uiwphhI5YG7.
إفصاح: كُتب هذا المقال بواسطة *فريق N3mak** (الشركة: AI N3mak globally)، صانعي بوابة N3mak AI Gateway. خطوات Cursor وContinue وOpen WebUI تتبع توثيق تلك المنتجات العام وسلوك بوابتنا الحي. لا ندّعي أننا أرخص من أي مزوّد آخر — اضبط العملاء، قِس على حمل عملك، ثم قرّر.*
Top comments (0)