DEV Community: Namak7678

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

Namak7678 — Thu, 12 Nov 2026 09:51:53 +0000

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

Use an OpenAI-Compatible API in Cursor, Continue, and Open WebUI (N3mak Gateway)

Namak7678 — Thu, 12 Nov 2026 09:41:53 +0000

If a tool already speaks the OpenAI Chat Completions shape, you can usually point it at any compatible base URL. This guide walks through three common setups — Cursor, Continue, and Open WebUI — using the public N3mak AI Gateway.

No vendor lock-in magic: you set a base URL, a Bearer key, and a model id. Everything below is what the gateway actually accepts today.

What you need


Base URL	`https://n3mak-gateway.n3mak.workers.dev/v1`
API key	Starts with `n3k_` (use `n3k_YOUR_KEY` in examples — never paste a live key into docs or git)
Default model	`gpt-oss-20b`
Auth header	`Authorization: Bearer n3k_YOUR_KEY`

The gateway exposes OpenAI-style routes including:

GET /v1/models (requires a valid Bearer key)
POST /v1/chat/completions (non-stream and simple SSE stream)

If you omit model, the worker defaults to gpt-oss-20b.

Models by plan (exact public ids)

Plan	Allowed model ids
Trial	`gpt-oss-20b`
Pioneer ($3)	`gpt-oss-20b`, `llama-3.1-8b`
Starter ($9)	Pioneer list + `gpt-oss-120b`, `mistral-small-3.1-24b`, `qwen2.5-coder-32b`
Pro ($49)	All of the above + `llama-3.3-70b`

Use the short public ids above in clients. Prefer those over prefixed aliases.

Marketing note: day-to-day we point people at the free trial and Pioneer. Higher plans exist in the worker; promote them only when you need their model list or limits.

Quick smoke test (`curl`)

Replace the placeholder locally — do not commit a real key.

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"}]
  }'

Optional discovery:

curl https://n3mak-gateway.n3mak.workers.dev/v1/models \
  -H "Authorization: Bearer n3k_YOUR_KEY"

1) Cursor

Open Cursor Settings → Models (macOS Cmd+Shift+J / Windows & Linux Ctrl+Shift+J).
Under API Keys, paste your key into OpenAI API Key → n3k_YOUR_KEY.
Enable Override OpenAI Base URL.
Set the URL to exactly:

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

Include /v1. Do not append /chat/completions.

Add custom model with name / id: gpt-oss-20b (Pioneer keys may also use llama-3.1-8b.)
Select that model in Chat or the local Agent and send a short test message.

Cursor caveats

Override is global for OpenAI-family traffic while it is on. Cursor-managed OpenAI models may also be routed to your custom base URL. Turn override off when you want Cursor's own subscription models again.
Bring-your-own-key / custom gateway applies to local Chat & Agent only. It does not cover Cursor Tab, Auto, Cloud/Background Agents, Automations, Cursor CLI, or the Cursor API/SDK.

2) Continue

Edit ~/.continue/config.yaml (or your project Continue config):

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

Reload Continue / restart the IDE extension, then pick N3mak gpt-oss-20b.

Continue caveats

Keep apiBase ending in /v1.
N3mak's worker exposes chat completions. Keep model on the allow-list for your plan. If a client tries a Responses-style path and misbehaves, Continue's docs mention forcing /chat/completions via useResponsesApi: false — use that only if you hit the issue.

3) Open WebUI

Open WebUI → Settings → Admin → Connections.
Under Manage OpenAI API Connections, click ➕ Add Connection.
URL / Base URL: https://n3mak-gateway.n3mak.workers.dev/v1
API Key: n3k_YOUR_KEY
Provider (Advanced): leave Default (plain OpenAI-compatible).
Click Verify Connection (it calls GET /v1/models). If verify fails but chat works, add model ids manually (gpt-oss-20b, plus any others allowed on your plan).
Save, then select the model in chat.

Environment alternative:

OPENAI_API_BASE_URL=https://n3mak-gateway.n3mak.workers.dev/v1
OPENAI_API_KEY=n3k_YOUR_KEY

Open WebUI caveats

Chat needs POST /v1/chat/completions. GET /v1/models helps discovery.
Embeddings / TTS / image endpoints are not assumed here — this guide only covers chat.
Use exactly …/v1 (no trailing-slash games).

Troubleshooting

Symptom	Likely cause
`model_not_found`	Typo — use the exact public ids from the table
`model_not_allowed` / 403	Model not on your plan's allow-list
401	Missing or bad `Bearer n3k_…` key
Cursor "works" but subscription models break	Leave Override OpenAI Base URL on — turn it off when not using the custom gateway

Security

Never commit real n3k_ keys to git, screenshots, or public posts.
Rotate a key if it leaks (bot / support path).

Try it free (no card)

Want a key before you buy?

Type /trial in @N3mak_bot.

24 hours
20 requests/day (also 5 requests/minute)
Model: gpt-oss-20b only
No card — no Whop payment on the trial path

After the trial, Pioneer ($3) uses the same gateway style; paid keys are delivered through @N3mak_bot within a few hours of Whop payment (not instant). Store: n3mak-buy.vercel.app · Pioneer checkout: whop.com/checkout/plan_n2uiwphhI5YG7.

Disclosure: this article was written by the **N3mak team* (company: AI N3mak globally), the makers of the N3mak AI Gateway. Steps for Cursor, Continue, and Open WebUI follow those products' public docs plus our live gateway behavior. We do not claim to be cheaper than any other provider — configure the clients, measure for your workload, and decide.*

DEV Community: Namak7678

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

ما تحتاجه

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

اختبار سريع (curl)

1) Cursor

تنبيهات Cursor

2) Continue

تنبيهات Continue

3) Open WebUI

تنبيهات Open WebUI

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

الأمان

جرّب مجانًا (بدون بطاقة)

Use an OpenAI-Compatible API in Cursor, Continue, and Open WebUI (N3mak Gateway)

What you need

Models by plan (exact public ids)

Quick smoke test (curl)

1) Cursor

Cursor caveats

2) Continue

Continue caveats

3) Open WebUI

Open WebUI caveats

Troubleshooting

Security

Try it free (no card)

اختبار سريع (`curl`)

Quick smoke test (`curl`)