كيف تستخدم واجهة متوافقة مع OpenAI في Cursor وContinue وOpen WebUI (بوابة N3mak)

إذا كانت أداتك تتحدث بصيغة OpenAI Chat Completions، يمكنك عادةً توجيهها إلى أي Base URL متوافق. هذا الدليل يشرح ثلاث إعدادات شائعة — Cursor وContinue وOpen WebUI — باستخدام بوابة N3mak AI Gateway العامة.

لا حاجة لطقوس معقّدة: Base URL + مفتاح Bearer + معرّف موديل. ما يلي هو ما تقبله البوابة فعليًا اليوم.

ما تحتاجه

المسارات بأسلوب OpenAI تشمل:

• GET /v1/models (يتطلب مفتاح Bearer صالحًا)
• POST /v1/chat/completions (بدون بث وبث SSE بسيط)

إذا حذفت model، يستخدم العامل gpt-oss-20b افتراضيًا.

الموديلات حسب الخطة (المعرّفات العامة الدقيقة)

استخدم المعرّفات القصيرة أعلاه داخل العملاء. فضّلها على الأسماء ذات البادئات.

ملاحظة تسويق: نركّز يوميًا على التجربة المجانية و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

1. افتح Cursor Settings → Models (macOS: Cmd+Shift+J / Windows وLinux: Ctrl+Shift+J).
2. في OpenAI API Key الصق n3k_YOUR_KEY.
3. فعّل Override OpenAI Base URL.
4. الصق العنوان حرفيًا:

https://n3mak-gateway.n3mak.workers.dev/v1

أبقِ /v1. لا تُلحق /chat/completions.

1. أضف موديلًا مخصصًا: gpt-oss-20b (مفاتيح Pioneer قد تستخدم أيضًا llama-3.1-8b.)
2. اختر الموديل في 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

1. Open WebUI → Settings → Admin → Connections.
2. ضمن Manage OpenAI API Connections اضغط ➕ Add Connection.
3. URL / Base URL: https://n3mak-gateway.n3mak.workers.dev/v1
4. API Key: n3k_YOUR_KEY
5. Provider (Advanced): اتركه Default (OpenAI-compatible عادي).
6. اضغط Verify Connection (يستدعي GET /v1/models). إذا فشل التحقق وعملت الدردشة، أضف معرّفات الموديل يدويًا (gpt-oss-20b وأي موديلات مسموحة في خطتك).
7. 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 حرفيًا.

استكشاف الأخطاء

الأمان

• لا ترفع مفاتيح 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 تتبع توثيق تلك المنتجات العام وسلوك بوابتنا الحي. لا ندّعي أننا أرخص من أي مزوّد آخر — اضبط العملاء، قِس على حمل عملك، ثم قرّر.*