التكامل

Connect EmpirioLabs to coding agents, IDEs, CLIs, conversation frontends, and OpenAI-compatible tools

معظم الأدوات تحتاج فقط إلى ثلاث قيم: مفتاح API، عنوان URL أساسي، ومعرف نموذج. EmpirioLabs يعرض إكمالات الدردشة المتوافقة مع OpenAI بالإضافة إلى نقطة نهاية رسائل على غرار Anthropic، لذا عادة ما يكون الإعداد عبارة عن قائمة منسدلة من مزود وتغيير رابط واحد.

أحدث التجهيزات

أديري أمرًا واحدًا لخلق ملفاتٍ محلية مختارة إضافة أدوات على مستوى المستعمل وفحص للدخان مع العلم

أدوات قابلة للمقارنة

استخدم https://api.empiriolabs.ai/v1 كرابط أساسي ومفتاح EmpirioLabs كرمز حامل.

Claude Code

يتوقع كلود كود شكل رسائل Anthropic. استخدم https://api.empiriolabs.ai بدون /v1 وحدد خيار النموذج المخصص.

كتيب نموذجي حي

اجلب GET /v1/models?available=true قبل ترميز معرفات النماذج في قوالب فرق أو سكريبتات مشتركة.

أحدث التجهيزات

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

1

أديروا القيادة

This default writes project-local files for OpenCode, Aider, Qwen Code, and OpenHands, including gitignored persistent accreditation for tools that can read them locally.

$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$script="${TMPDIR:-/tmp}/empirio-integrations-setup.py"
$curl -fsSL "https://docs.empiriolabs.ai/integrations/setup.py" -o "$script"
$python3 "$script" \
> --scope project \
> --tools opencode,aider,qwen-code,openhands \
> --model qwen3-max
2

نطاق الاختيار والأدوات

غيّر آخر الأعلام عندما تريد تركيبة مختلفة:

الهدفالعلم
ملفات المشاريع فقط--scope project --tools opencode,aider,qwen-code,openhands
أدوات على مستوى المستعملين أيضا--scope all --tools all
أداة واحدة فقط--tools opencode أو --tools claude-code أو أي أداة من الجدول أدناه
اختر نموذج التقصير--model <model-id>
Only register the default model (skip auto-populate)--no-populate-models
التحقق من المفتاح والائتماناتأضف --smoke-test
أسماء الأدوات المدعومة بالطباعة--list-tools

علم --tools يأخذ قيما دقيقة ومفصولة بفاصل. لا تدرج المسافات إلا إذا احتفظت القشرة بالقيمة الكاملة المكتوبة.

--tools valueالنطاقالكتابات
opencodeالمشروعopencode.json plus .empiriolabs-api-key
aiderالمشروع.aider.empiriolabs.yml
qwen-codeالمشروع أو المستخدم.qwen/settings.json or ~/.qwen/settings.json
openhandsالمشروعopenhands.empiriolabs.toml
continueمستعمل~/.continue/config.yaml أو إعدادات العربة الجانبية
claude-codeمستعمل~/.claude/settings.json env values
codexمستعملتم وضع علامة على الكتلة في ~/.codex/config.toml
hermesمستعمل~/.hermes/empiriolabs.config.yaml sidecar
gooseمستعملمُقدِّم خدمات الأوزة
openclawمستعمل~/.openclaw/empiriolabs.example.json5 sidecar
allتم اختياره من قبل --scopeكُلّ أداة مُساندة للمُساعدينِ لذلك الركض
3

التحميل اليدوي

استعمل هذا فقط اذا اغلقت قذيفتك

Download empirio-integrations-setup.py

ثمّ يَرْكضُ المُساعدَ حيثما تُريدُ ملفاتَ مُحلّقةِ مُحلّقةِ مشروعِ:

$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$python3 empirio-integrations-setup.py --scope project --tools opencode,aider,qwen-code,openhands --model qwen3-max

The helper creates timestamped supports before changing existing files, but it can write API keys into local .env, .empiriolabs-api-key, .qwen/settings.json, openhands.empiriolabs.toml, and some user config files. -الإستعراض قدّم ملفات قبل ارتكاب أيّ شيء. المُساعد لا يُثبت الأدوات نفسها.

ما كتبه المساعد

بشكل افتراضي، يقوم المساعد بجلب كتالوج live /v1/models?available=true ويكتب كل نموذج قادر على الدردشة (نص، متعدد الوسائط، برمج، استدلال) في أدوات تدعم إعداداتها الأصلية أداة اختيار متعددة النماذج (OpenCode، Continue، Qwen Code، goose). علم --model يختار الإعداد الافتراضي داخل تلك المجموعة المملوءة. مرر --no-populate-models إذا كنت تريد فقط النموذج الافتراضي المسجل.

مادة أو ملف--tools valueالنطاقالذي خلق
Shared envدائما لنطاق المشروعالمشروع.env, .empiriolabs-api-key, empirio-env.sh, empirio-env.ps1, and .gitignore entries for local secrets
وثيقة مفتوحةopencodeالمشروعمزود opencode.json اسمه empiriolabs، ويحتوي على كل نموذج قابل للدردشة، ونماذج قادرة على التفكير الموسوم بعلامة reasoning: true، ويشير إلى .empiriolabs-api-key للاستمرارية
Aideraiderالمشروع.aider.empiriolabs.yml (Single default model, shift via --model)
Qwen الشيفرةqwen-codeالمشروع أو المستخدم.qwen/settings.json أو ~/.qwen/settings.json مع إدخال مزود واحد لكل نموذج دردشة، وتحديد OpenAI المصادقة، وقيم env احتياطية
أفتحopenhandsالمشروعopenhands.empiriolabs.toml plus LLM_* values in the generated env files
استمرcontinueمستعمل~/.continue/config.yaml أو ~/.continue/empiriolabs.config.yaml models: مصفوفة مكتملة، بالإضافة إلى ~/.continue/.env
Claude Codeclaude-codeمستعمل~/.claude/settings.json env values
Codex CLIcodexمستعملتم وضع علامة على الكتلة في ~/.codex/config.toml
”عميل “هيرمزhermesمستعمل~/.hermes/empiriolabs.config.yaml sidecar and ~/.hermes/.env
الأوزةgooseمستعملمزود مخصص JSON مع كل نموذج قادر على الدردشة في مصفوفة models[]
OpenClawopenclawمستعمل~/.openclaw/empiriolabs.example.json5 sidecar

يقوم المساعد بالتحقق من أسماء الأدوات ويخرج بخطأ لقيم غير معروفة. إذا لم تتطابق الأداة المختارة مع النطاق المختار، يقوم المساعد بطباعة ملاحظة. على سبيل المثال، --scope project --tools codex لا يكتب إعدادات Codex لأن Codex هو إعداد على مستوى المستخدم.

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

تحديث القائمة النموذجية بعد إطلاق جديد

يقوم المساعد بجلب GET /v1/models?available=true في كل تشغيل ويعيد كتابة إعدادات النماذج المتعددة من تلك اللقطة الحية، بحيث تعكس قائمة النماذج المسجلة النماذج التي يتم إطلاقها في لحظة تنفيذ المساعد. إعادة تشغيل نفس الأمر بعد إطلاق نموذج جديد تضيفه إلى opencode.json OpenCode، وconfig.yaml Continue، وقائمة مزودي settings.json Qwen Code، وJSON الخاص بمزود المخصص من Goose دون أي تعديلات أخرى. لا تحتفظ Aider وOpenHands وClaude Code وCodex CLI وHermes Agent وOpenClaw بسجل متعدد النماذج في إعداداتها، لذا فإن تلك الأدوات تقرأ دائما النموذج الذي يمرره الكود عند وقت الطلب، مما يعني أنه لا حاجة لإعادة تشغيل المساعد لتلك الأدوات عند إطلاق نموذج جديد.

Re-run after a new model launches
$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$script="${TMPDIR:-/tmp}/empirio-integrations-setup.py"
$curl -fsSL "https://docs.empiriolabs.ai/integrations/setup.py" -o "$script"
$python3 "$script" --scope project --tools opencode,aider,qwen-code,openhands --model qwen3-max

تأهب للسيارات (يتم تفاديه)

The setup command installs a platform-native scheduled task that re-fetches the EmpirioLabs model list every 6 hours so newly launched models appear in OpenCode, Qwen Code, Continue, and goose without any manual step. وتدار هذه الوظيفة بمفردها، في الخلفية، دون أن تكون هناك حاجة إلى دورة للقصف:

  • ** Linux**: a marked entry in your user crontab (visible with crontab -l)
  • MacOS: a user LaunchAgent at ~/Library/LaunchAgents/ai.empiriolabs.refresh.plist
  • ويندوز: مهمة جدولة المهام باسم “EmpirioLabs التحديث التلقائي”

وتقرأ الوظيفة مفتاح ” API ” من ~/.empiriolabs/.empiriolabs-api-key (المود 600 وتتجه اللوجز (المخدرات) والغطس (Linux/Windows) إلى ~/.empiriolabs/refresh.log.

مرر --no-auto-refresh إلى القيادة الإعدادية للاختيار، أو تشغيل المساعد في وقت لاحق مع --uninstall-auto-refresh لإزالة المهمة المقررة وتنظيف نقاط العلامات.

Opt out of auto-refresh
$python3 "$script" --scope project --tools opencode,aider,qwen-code,openhands --model qwen3-max --no-auto-refresh
Remove an existing auto-refresh
$curl -fsSL https://docs.empiriolabs.ai/integrations/setup.py | python3 - --uninstall-auto-refresh

قيم الربط

Settingاستخدام هذه القيمة
قاعدة قابلة للتعديلhttps://api.empiriolabs.ai/v1
Anthropic / رابط قاعدة كود كلودhttps://api.empiriolabs.ai
مفتاح APIمفتاح لوحة التحكم الخاص بك، عادة sk-empiriolabs-...
رئيس الأذونAuthorization: Bearer $EMPIRIOLABS_API_KEY
النموذج الأول للاختبارqwen3-max
كتيب نموذجي حيGET https://api.empiriolabs.ai/v1/models?available=true

بالنسبة للأدوات المتوافقة مع OpenAI، يجب عادة أن ينتهي رابط القاعدة عند /v1. لا تلصق مسار /v1/chat/completions الكامل في حقل رابط أساسي إلا إذا طلبت الأداة صراحة رابط نقطة نهاية كاملة.

ضوابط التفكير والتفسير

EmpirioLabs يعرض ضوابط التفكير فقط على النماذج التي تدرجها في صفحة النموذج أو المخطط القابل للقراءة آليا. لا ترسل هذه الحقول إلى كل نموذج بشكل افتراضي.

بالنسبة لإكمال وردود الدردشة المتوافقة مع OpenAI، يمكن أن تشمل الضوابط المدعومة enable_thinking أو thinking_budget أو reasoning_effort، حسب النموذج:

1{
2 "model": "qwen3-max-thinking",
3 "messages": [
4 { "role": "user", "content": "Answer briefly." }
5 ],
6 "enable_thinking": false
7}

بالنسبة لنقطة نهاية الرسائل الأنثروبيكية، استخدام أسلوب الأنثروبيك للتفكير عندما يدعم النموذج التفكير:

1{
2 "model": "qwen3-max-thinking",
3 "messages": [
4 { "role": "user", "content": "Work through this carefully." }
5 ],
6 "thinking": {
7 "type": "enabled",
8 "budget_tokens": 1024
9 }
10}

reasoning_effort يقبل none وlow وmedium وhigh وmax في كل نموذج يستحق الاستدلال. EmpirioLabs يقوم بتطبيع القيمة إلى حقول الاستدلال المدعومة للنموذج المختار، بحيث تعمل نفس سلسلة الجهد عبر عائلات النماذج بغض النظر عما إذا كانت خدمة النموذج تتوقع reasoning_effort أو enable_thinking أو thinking_budget بشكل أصلي.

1{
2 "model": "deepseek-v4-pro",
3 "messages": [
4 { "role": "user", "content": "Solve this carefully." }
5 ],
6 "reasoning_effort": "max"
7}

يتباين الدعم في مجال العنف:

Toolكيفية إدارة المنطق
وثيقة مفتوحةيقوم المساعد بتحديد نماذج قادرة على التفكير reasoning: true في opencode.json. تقرأ OpenCode كتالوج النماذج الداخلي الخاص بها لتحديد أي متغيرات الجهد ستظهرها في أداة اختيار /models لكل معرف نموذج، لذا تختلف الخيارات المرئية حسب العائلة: بعض النماذج تعرض none وlow وmedium وhigh وmax، بينما تظهر أخرى فقط none، low، medium، high. EmpirioLabs يقبل كل نسخة يرسلها OpenCode ويقبل max من أي عميل حتى عندما لا يظهرها OpenCode لذلك النموذج، لذا يمكنك تمرير reasoning_effort: "max" مباشرة من المكالمات المخصصة عند الحاجة. none يعني عدم وجود تجاوز للجهاز، لذا لا يزال النموذج الافتراضي ينطبق.
Aiderاستخدم --reasoning-effort low، --reasoning-effort medium، --reasoning-effort high، /reasoning-effort low، --thinking-tokens 0، أو /thinking-tokens 0 عندما يدعم النموذج المختار هذا التحكم.
Qwen الشيفرةويمكن لدخلات مقدمي الخدمات أن تحمل نماذج البيانات الفوقية والجيل. أبقوا المساعدين متخلفين إلا إذا أردتم أن تضعوا طريقة تفكير على نطاق الفريق لنموذج واحد
Codex CLIاستخدم model_reasoning_effort أو plan_mode_reasoning_effort في ~/.codex/config.toml للنماذج القادرة على الاستدلال. المساعد يوصل فقط مزود EmpirioLabs ويترك الجهد غير محدد.
جبهات شاتلا تستخدم البارامترات العرفية أو الأطر النموذجية المتقدمة إلا عندما يعرضها التطبيق. إن لم يكن كذلك، اختاري نموذجاً يضاهي سلوك التفكير الناقص سير العمل

اختبار الدخان

أدير هذا قبل تشكيل أداة أكبر إذا كان هذا يعمل، مفتاحك، الائتمانات، الشبكة، والهوية النموذجية جيدة.

$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$
$curl "https://api.empiriolabs.ai/v1/chat/completions" \
> -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
> -H "Content-Type: application/json" \
> -d '{
> "model": "qwen3-max",
> "messages": [
> { "role": "user", "content": "Reply with one sentence." }
> ]
> }'

لقائمة بطاقات الهوية النموذجية الحالية:

$curl "https://api.empiriolabs.ai/v1/models?available=true" \
> -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

واجهات التحدي والدور

استخدم هذا القسم لتطبيقات الدردشة في BYOK، وأدوات تقمص الأدوار، وواجهات الويب المشتركة. عادة لا تحتاج هذه الأدوات إلى سكريبت المساعد. استخدم مفتاح واجهة برمجة التطبيقات EmpirioLabs، واختر نموذج دردشة مثل qwen3-max، واحتفظ بالأسرار في إعدادات التطبيق المحلية أو متغيرات البيئة.

بالنسبة لمحادثات تقمص الأدوار، نوصي عموما بالبدء بنماذج EmpirioLabs Native Inference أولا، ثم النماذج أو النسخ المدرجة في منطقة Singapore عندما لا تناسب التغطية الأصلية حالتك. تحقق من صفحة النماذج أو صفحة السعر قبل اختيار النموذج. كل نموذج يذكر موقعه الذي يخدم هناك. بالنسبة للنماذج التي تحتوي على نسخ، تحقق من مدخلات المتغيرات أيضا، لأن النسخة يمكن أن تقدم من منطقة مختلفة.

Toolميدان نقطة النهايةالقيمة
SillyTavernنقطة نهاية العقد/قاعدة URLhttps://api.empiriolabs.ai/v1
PersonaLMقاعدة محرك النصوص العرفيةhttps://api.empiriolabs.ai/v1
Janitor AIProxy URLhttps://api.empiriolabs.ai/v1/chat/completions
نموذج تقليدينقطة النهايةhttps://api.empiriolabs.ai/v1/chat/completions
Open WebUIرابط OpenAI الاتصالhttps://api.empiriolabs.ai/v1
LibreChatbaseURLhttps://api.empiriolabs.ai/v1
(لوبي تشات)OPENAI_PROXY_URLhttps://api.empiriolabs.ai/v1

SillyTavern

SillyTavern هو واجهة أمامية محلية للعب الأدوار والدردشة مع الشخصيات. يعمل EmpirioLabs من خلال مصدر إكمال الدردشة المخصص المتوافق مع OpenAI.

  1. افتح (سيلي تافيرن) و اضغط على جهاز التحكم لفتح قنوات الاتصال
  2. اضبط نوع API على Chat Completion.
  3. اضبط مصدر إكمال الدردشة على Custom (OpenAI-compatible).
  4. وضع نقطة نهاية تعريفية/قاعدة URL إلى https://api.empiriolabs.ai/v1.
  5. الصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك في حقل مفتاح API مخصص.
  6. كليك كونتيك، ثم اختيار نموذج من الانزال أو نوع هويّة نموذجية مثل qwen3-max.

لا تلصق https://api.empiriolabs.ai/v1/chat/completions في حقل رابط SillyTavern الأساسي. يضيف SillyTavern مسار إكمال الدردشة نفسه.

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

PersonaLM

PersonaLLM هو تطبيق تقمص أدوار ودردشة شخصيات على iOS مع إعدادات bring-your-own-key مزودي الخدمة. EmpirioLabs يعمل من خلال محرك النصوص المخصص ل PersonaLLM.

  1. من الشاشة المنزلية، اسحب قائمة ثلاث دول في الأعلى اليسار.
  2. أفتحوا “ستينغز”
  3. محرك مفتوح
  4. اختر العرف
  5. اضبط رابط القاعدة على https://api.empiriolabs.ai/v1.
  6. قم بلصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك.
  7. في حقل العارضات، اضغط الزر على الحق في جلب قائمة النموذج الحي.
  8. اختر نموذج الدردشة مثل qwen3-max أو glm-5-1 ، ثم وفر محركات النص.

زر التفكير في PersonaLLM يرسل إعداد تفكير عند تفعيله ويحذف ضوابط التفكير عند تعطيله. EmpirioLabs يعامل حقل PersonaLLM المغفل على أنه يفكر فقط للنماذج التي يكون فيها الافتراضي هو التفكير. يتم تحديد هذا السلوك التوافقي لطلبات PersonaLLM؛ يجب على الأدوات الأخرى إرسال معلمات استدلال صريحة عندما تحتاج إلى تجاوز افتراضي النموذج.

Janitor AI

يمكن للذكاء الاصطناعي لعامل النظافة الاتصال EmpirioLabs من خلال تكوين الوكيل الخاص به. استخدم هذا المسار عندما تريد الاستمرار في استخدام واجهة دردشة عامل النظافة مع إحضار مفتاح EmpirioLabs خاص بك.

  1. افتحي دردشة جانيتور
  2. انقر على using janitor أو زر القائمة بالقرب من أعلى الدردشة.
  3. افتح API Settings.
  4. اختر تبويب Proxy.
  5. In Proxy Configurations, knock + New.
  6. اضبط الاسم على EmpirioLabs.
  7. اضبط النموذج على qwen3-max، أو معرف نموذج آخر من GET /v1/models?available=true.
  8. اضبط رابط البروكسي على https://api.empiriolabs.ai/v1/chat/completions.
  9. الصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك في مفتاح API.
  10. أترك (كوزتوم برومبت) فارغاً إلا إذا كنت تستخدم واحداً من أجل تلك الشخصية أو الدردشة
  11. (كليك أد) ، أنقذي البيئات ثم أعيدي فتح صفحة (جانيتور آي) قبل إرسال الرسالة التالية

إذا كان لدى النظافة الاصطناعي مساعد + /chat/completions بجانب حقل رابط الوكيل، ابدأ ب https://api.empiriolabs.ai/v1 ودع المساعد يضيف المسار. يجب أن ينتهي رابط الحفظ ب /v1/chat/completions.

الطباعة

طباعة (ميند) يدعم نماذج الدردشة العرفية حيث تقدمين نقطة النهاية، هويّة نموذجيّة، وراسميّن اختياريين.

  1. افتح Models من الشريط الجانبي الأيسر.
  2. افتح إعدادات النموذج، ثم اضغط Add Custom Models.
  3. استخدم نوع API OpenAI Chat Completions API إذا طلب النموذج ذلك.
  4. اضبط واجهة برمجة تطبيقات نقطة النهاية على https://api.empiriolabs.ai/v1/chat/completions.
  5. وضع هوية نموذجية لـ qwen3-max أو نموذج آخر متاح.
  6. أضف Authorization: Bearer sk-empiriolabs-your_key_here الرأس، أو الصق المفتاح في حقل مفتاح API الخاص ب TypingMind إذا كان النموذج يوفر واحدا.
  7. “إختبار الذكاء، ثم أضف النموذج”

إعداد نموذج مخصص من TypingMind هو الاستثناء الرئيسي في هذه الصفحة: عادة ما يطلب نقطة نهاية إكمال الدردشة بالكامل، وليس فقط رابط القاعدة /v1.

Open WebUI

ويمكن لشبكة الإنترنت المفتوحة أن تتواصل مع مقدمي الخدمات المتوافقين مع نظام ” OpenAI ” من شاشات الاتصال المميزة.

  1. افتحي (أدمين ستينغز)
  2. اذهب إلى Connections وأضف اتصال OpenAI جديد.
  3. اضبط رابط الرابط على https://api.empiriolabs.ai/v1.
  4. قم بلصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك.
  5. وإذا كان الاكتشاف النموذجي بطيئاً أو واسعاً جداً، تُضاف هويات نموذجية مثل qwen3-max إلى مرشح الهويات النموذجية.
  6. احفظ، ثم اختر نموذج EmpirioLabs في الدردشة.

بالنسبة لعمليات إطلاق الخواديم، المجموعة:

$OPENAI_API_BASE_URL=https://api.empiriolabs.ai/v1
$OPENAI_API_KEY=sk-empiriolabs-your_key_here

LibreChat

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

librechat.yaml
1version: 1.3.5
2cache: true
3endpoints:
4 custom:
5 - name: "EmpirioLabs"
6 apiKey: "${EMPIRIOLABS_API_KEY}"
7 baseURL: "https://api.empiriolabs.ai/v1"
8 models:
9 default: ["qwen3-max"]
10 fetch: true
11 titleConvo: true
12 titleModel: "qwen3-max"
13 modelDisplayLabel: "EmpirioLabs"
.env
$EMPIRIOLABS_API_KEY=sk-empiriolabs-your_key_here

بالنسبة لنشر BYOK متعدد المستخدمين، قم بتغيير apiKey إلى:

1apiKey: "user_provided"

أعد تشغيل LibreChat بعد تغيير librechat.yaml.

LobeChat

For self-hosted LobeChat, use the OpenAI provider with the EmpirioLabs API base URL:

.env
$OPENAI_API_KEY=sk-empiriolabs-your_key_here
$OPENAI_PROXY_URL=https://api.empiriolabs.ai/v1
$OPENAI_MODEL_LIST=+qwen3-max,+glm-5-1,+deepseek-v4-pro:variant2

ثم أعد تشغيل LobeChat واختر نموذج EmpirioLabs مفعل في محدد النماذج.

LiteLLM

EmpirioLabs مزود مدمج في LiteLLM، لذا يمكن لمجموعة تطوير البرمجيات ووكيل LiteLLM التوجيه إلى أي نموذج دردشة EmpirioLabs باستخدام بادئة empiriolabs/. في إصدارات LiteLLM التي سبقت المزود، استخدم النسخة الاحتياطية المتوافقة مع OpenAI أدناه.

LiteLLM SDK
1import os
2import litellm
3
4os.environ["EMPIRIOLABS_API_KEY"] = "sk-empiriolabs-your_key_here"
5
6response = litellm.completion(
7 model="empiriolabs/qwen3-7-plus",
8 messages=[{"role": "user", "content": "Hello!"}],
9)
LiteLLM Proxy config.yaml
1model_list:
2 - model_name: qwen3-7-plus
3 litellm_params:
4 model: empiriolabs/qwen3-7-plus
5 api_key: os.environ/EMPIRIOLABS_API_KEY

يمكن أن تستخدم نسخ ” LiteLM ” القديمة (أو توليد الصور) الطريق المتوافق مع ” OpenAI ” مباشرة:

Fallback / image generation
1import os
2import litellm
3
4response = litellm.image_generation(
5 prompt="A glass cathedral at sunset, dramatic lighting",
6 model="openai/seedream-5-0-lite",
7 api_base="https://api.empiriolabs.ai/v1",
8 api_key=os.environ["EMPIRIOLABS_API_KEY"],
9 extra_body={"sync": True},
10)

يجعل حقل sync: true نقطة نهاية الصورة تعيد الاستجابة النهائية على شكل OpenAI بدلا من غلاف المهام غير المتزامنة الافتراضي. صفحة مزود الخدمة الخاصة ب LiteLLM ل EmpirioLabs هي على docs.litellm.ai/docs/providers/empiriolabs.

وثيقة مفتوحة

يمكن للمساعد أن يكتب هذا تلقائياً

$python3 empirio-integrations-setup.py --tools opencode --model qwen3-max

وضع الدليل:

opencode.json
1{
2 "$schema": "https://opencode.ai/config.json",
3 "provider": {
4 "empiriolabs": {
5 "npm": "@ai-sdk/openai-compatible",
6 "name": "EmpirioLabs",
7 "options": {
8 "baseURL": "https://api.empiriolabs.ai/v1",
9 "apiKey": "{file:.empiriolabs-api-key}"
10 },
11 "models": {
12 "qwen3-max": {
13 "name": "EmpirioLabs Qwen3-Max"
14 },
15 "qwen3-max-thinking": {
16 "name": "EmpirioLabs Qwen3-Max-Thinking",
17 "reasoning": true
18 }
19 }
20 }
21 }
22}
$printf '%s' 'sk-empiriolabs-your_key_here' > .empiriolabs-api-key
$printf '\n.empiriolabs-api-key\n' >> .gitignore
$opencode

In OpenCode, run /models and choose the EmpirioLabs provider. المفتاح المدعوم بالملف يستمر بالعمل بعد أن تغلق وتعيد فتح باب التسجيل

Claude Code

ويمكن للمساعد أن يكتب الأطر على مستوى المستخدم تلقائيا:

$python3 empirio-integrations-setup.py --scope user --tools claude-code --model qwen3-max

كود كلود ليس عميل إكمال الدردشة في OpenAI. يتحدث مع بوابات نماذج اللغة الكبيرة من خلال شكل رسائل Anthropic، والذي EmpirioLabs يعرض عند /v1/messages.

$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$
$# Claude Code sends ANTHROPIC_AUTH_TOKEN as a Bearer token.
$export ANTHROPIC_AUTH_TOKEN="$EMPIRIOLABS_API_KEY"
$
$# Claude Code appends /v1/messages itself, so do not include /v1 here.
$export ANTHROPIC_BASE_URL="https://api.empiriolabs.ai"
$
$export ANTHROPIC_CUSTOM_MODEL_OPTION="qwen3-max"
$export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="EmpirioLabs Qwen3-Max"
$export ANTHROPIC_MODEL="qwen3-max"
$
$claude

تركيبة مستمرة على مستوى المستعملين:

~/.claude/settings.json
1{
2 "env": {
3 "ANTHROPIC_AUTH_TOKEN": "sk-empiriolabs-your_key_here",
4 "ANTHROPIC_BASE_URL": "https://api.empiriolabs.ai",
5 "ANTHROPIC_CUSTOM_MODEL_OPTION": "qwen3-max",
6 "ANTHROPIC_CUSTOM_MODEL_OPTION_NAME": "EmpirioLabs Qwen3-Max",
7 "ANTHROPIC_MODEL": "qwen3-max"
8 }
9}

استخدم نموذجا تسرد صفحاته POST /v1/messages تحت نقاط النهاية المدعومة. إذا أبلغ Claude Code عن خطأ في عد الرموز الخاصة بالبوابة أو اكتشاف النموذج، قم بتشغيله عبر بوابة أو محول بصيغة Anthropic ينفذ عقد بوابة كلود كود الكامل، ثم وجه تلك البوابة إلى EmpirioLabs.

Cline

In the Cline extension UI:

  1. فتح كلين.
  2. اضبط مزود واجهة برمجة التطبيقات على OpenAI Compatible.
  3. اضبط عنوان URL الأساسي على https://api.empiriolabs.ai/v1.
  4. قم بلصق مفتاح واجهة برمجة التطبيقات EmpirioLabs الخاص بك.
  5. أدخل معرف النموذج مثل qwen3-max.
  6. قم بالتحقق، ثم أبدأ مهمة جديدة.

لكلين كلي:

$npm install -g cline
$
$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$
$cline auth \
> -p openai \
> -k "$EMPIRIOLABS_API_KEY" \
> -b "https://api.empiriolabs.ai/v1" \
> -m "qwen3-max"
$
$cline "Inspect this repository and suggest the safest next refactor."

Qwen الشيفرة

ويمكن للمساعد أن يكتب المشاريع أو أماكن الاستخدام تلقائيا:

$python3 empirio-integrations-setup.py --scope project --tools qwen-code --model qwen3-max

إطلاق Qwen Code مباشرة مع EmpirioLabs كمزود متوافق مع OpenAI:

$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$
$qwen \
> --auth-type openai \
> --openaiApiKey "$EMPIRIOLABS_API_KEY" \
> --openaiBaseUrl "https://api.empiriolabs.ai/v1" \
> --model "qwen3-max"

For persistent project setup:

.qwen/settings.json
1{
2 "model": {
3 "name": "qwen3-max"
4 },
5 "security": {
6 "auth": {
7 "selectedType": "openai"
8 }
9 },
10 "env": {
11 "EMPIRIOLABS_API_KEY": "sk-empiriolabs-your_key_here"
12 },
13 "modelProviders": {
14 "openai": [
15 {
16 "id": "qwen3-max",
17 "name": "EmpirioLabs Qwen3-Max",
18 "envKey": "EMPIRIOLABS_API_KEY",
19 "baseUrl": "https://api.empiriolabs.ai/v1"
20 }
21 ]
22 }
23}

أضف .qwen/settings.json إلى .gitignore إذا خزنت المفتاح هناك.

Codex CLI

ويمكن للمساعد أن يكتب تلقائياً كتلة مقدمي الخدمات على مستوى المستعملين:

$python3 empirio-integrations-setup.py --scope user --tools codex --model qwen3-max

أضف EmpirioLabs كمزود نموذج مخصص في ~/.codex/config.toml:

~/.codex/config.toml
1model = "qwen3-max"
2model_provider = "empiriolabs"
3
4[model_providers.empiriolabs]
5name = "EmpirioLabs"
6base_url = "https://api.empiriolabs.ai/v1"
7env_key = "EMPIRIOLABS_API_KEY"
8wire_api = "responses"

ثم إطلاق الكودوكس مع مفتاحك في البيئة:

$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$codex

استخدم هذا المسار مع EmpirioLabs نماذج تدعم POST /v1/responses.

Aider

ويمكن للمساعد أن يكتب تلقائياً عقداً للمعونة على مستوى المشاريع:

$python3 empirio-integrations-setup.py --tools aider --model qwen3-max

يستخدم Aider متغيرات البيئة المتوافقة مع OpenAI. النموذج يبدأ بالبادئة openai/.

$export OPENAI_API_BASE="https://api.empiriolabs.ai/v1"
$export OPENAI_API_KEY="sk-empiriolabs-your_key_here"
$
$aider --model openai/qwen3-max

استمر

يمكن للمساعد أن يكتب الوصية على مستوى المستعمل

$python3 empirio-integrations-setup.py --scope user --tools continue --model qwen3-max

يمكن لمزود OpenAI في Continue استهداف أي نقطة نهاية متوافقة مع OpenAI من خلال تعيين apiBase. ضع الأسرار في .env أو متجر كونتينيو السري بدلا من تسجيلها في config.yaml.

~/.continue/config.yaml
1name: EmpirioLabs
2version: 0.0.1
3schema: v1
4
5models:
6 - name: EmpirioLabs Qwen3-Max
7 provider: openai
8 model: qwen3-max
9 apiBase: https://api.empiriolabs.ai/v1
10 apiKey: ${{ secrets.EMPIRIOLABS_API_KEY }}
11 capabilities:
12 - tool_use

أضف السر في أحد المواقع .env المدعومة من Continue:

~/.continue/.env
$EMPIRIOLABS_API_KEY=sk-empiriolabs-your_key_here

أفتح

ويمكن للمساعد أن يكتب مستنداً تلقائياً على مشروع ” أوف هاندز ”:

$python3 empirio-integrations-setup.py --tools openhands --model qwen3-max

فتح الهوامش يكشف عن أماكن مقدمي الخدمات في وحدة التفتيش المشتركة ويعبرها إلى طبقة LLM.

الميدانالقيمة
LLM ProviderOpenAI
LLM Modelopenai/qwen3-max
API Keyمفتاحك EmpirioLabs
القاعدة URLhttps://api.empiriolabs.ai/v1

بالنسبة لعمليات الإطلاق القائمة على البيئة:

$export LLM_MODEL="openai/qwen3-max"
$export LLM_BASE_URL="https://api.empiriolabs.ai/v1"
$export LLM_API_KEY="sk-empiriolabs-your_key_here"

For persistent project setup:

openhands.empiriolabs.toml
1[llm]
2model = "openai/qwen3-max"
3api_key = "sk-empiriolabs-your_key_here"
4base_url = "https://api.empiriolabs.ai/v1"

اركضوا في “افتح هادز” مع:

$openhands --config-file openhands.empiriolabs.toml

أضف openhands.empiriolabs.toml إلى .gitignore إذا خزنت المفتاح هناك.

”عميل “هيرمز

يمكن للمساعد أن يكتب سيارة (هيرمز) على مستوى المستعمل تلقائياً:

$python3 empirio-integrations-setup.py --scope user --tools hermes --model qwen3-max

هيرميس لديه ساحر نماذج تفاعلي. اختر Custom endpoint، ثم أدخل:

Promptالقيمة
قاعدة API URLhttps://api.empiriolabs.ai/v1
مفتاح APIمفتاحك EmpirioLabs
الاسم النموذجيqwen3-max

الوصية اليدوية:

~/.hermes/config.yaml
1custom_providers:
2 - name: empiriolabs
3 base_url: https://api.empiriolabs.ai/v1
4 key_env: EMPIRIOLABS_API_KEY
5
6model:
7 provider: custom:empiriolabs
8 default: qwen3-max
~/.hermes/.env
$EMPIRIOLABS_API_KEY=sk-empiriolabs-your_key_here

OpenClaw

يمكن للمساعد أن يكتب سيارة على مستوى المستعمل

$python3 empirio-integrations-setup.py --scope user --tools openclaw --model qwen3-max

أأمن مجموعة هي الساحرة المفتوحة

$openclaw configure --section model

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

الميدانالقيمة
هوية مقدِّمempiriolabs
API adapteropenai-completions
القاعدة URLhttps://api.empiriolabs.ai/v1
مفتاح APISecretRef إلى EMPIRIOLABS_API_KEY، أو مفتاحك لاختبار محلي فقط
النموذج النموذجيqwen3-max

من أجل الثقب اليدوي لـ (شيون 5) إستخدم هذه كسيارة جانبية أو إدمجها في وعاء (إف سيلو)

~/.openclaw/empiriolabs.example.json5
1{
2 secrets: {
3 providers: {
4 default: { source: "env" }
5 },
6 defaults: {
7 env: "default"
8 }
9 },
10 models: {
11 mode: "merge",
12 providers: {
13 empiriolabs: {
14 baseUrl: "https://api.empiriolabs.ai/v1",
15 apiKey: { source: "env", provider: "default", id: "EMPIRIOLABS_API_KEY" },
16 authHeader: true,
17 api: "openai-completions",
18 models: [
19 {
20 id: "qwen3-max",
21 name: "EmpirioLabs Qwen3-Max",
22 input: ["text"],
23 contextWindow: 256000
24 }
25 ]
26 }
27 }
28 },
29 agents: {
30 defaults: {
31 model: {
32 primary: "empiriolabs/qwen3-max"
33 }
34 }
35 }
36}

شغل openclaw config validate بعد التعديلات اليدوية.

الأوزة

ويمكن للمساعد أن يكتب مُقدِّم العتاد على مستوى المستعمل تلقائياً:

$python3 empirio-integrations-setup.py --scope user --tools goose --model qwen3-max

تدعم Goose مزودي خدمة متوافقين مع OpenAI مخصصين. يكتب المساعد هذا كempiriolabs.json في مجلد مزود المخصص الخاص ب goose.

empiriolabs.json
1{
2 "name": "empiriolabs",
3 "engine": "openai",
4 "display_name": "EmpirioLabs",
5 "description": "EmpirioLabs OpenAI-compatible API",
6 "api_key_env": "EMPIRIOLABS_API_KEY",
7 "base_url": "https://api.empiriolabs.ai/v1/chat/completions",
8 "models": [
9 {
10 "name": "qwen3-max",
11 "context_limit": 256000
12 }
13 ],
14 "supports_streaming": true,
15 "requires_auth": true
16}
$export EMPIRIOLABS_API_KEY="sk-empiriolabs-your_key_here"
$goose session start --provider empiriolabs

Zed

وتدعم شركة Zed مقدمي الخدمات المتوافقين مع المعايير المحاسبية الدولية للقطاع العام في فريق العميل. إستعملْ UI’s Add Provider تدفقْ، أَو محرر

Zed settings.json
1{
2 "language_models": {
3 "openai_compatible": {
4 "EmpirioLabs": {
5 "api_url": "https://api.empiriolabs.ai/v1",
6 "available_models": [
7 {
8 "name": "qwen3-max",
9 "display_name": "EmpirioLabs Qwen3-Max",
10 "max_tokens": 256000,
11 "capabilities": {
12 "tools": true,
13 "images": false,
14 "parallel_tool_calls": false,
15 "prompt_cache_key": false
16 }
17 }
18 ]
19 }
20 }
21 }
22}

أضف المفتاح من خلال فريق العميل كي يخزنه (زيد) في متجر الحرق

Klo Code, Roo Code, Cursor, and similar IDEs

استخدم هذا الجدول في أي مكان تعرض فيه أداة OpenAI Compatible أو Custom OpenAI أو Override OpenAI Base URL.

الميدانالقيمة
مقدِّمOpenAI Compatible
القاعدة URLhttps://api.empiriolabs.ai/v1
مفتاح APIمفتاحك EmpirioLabs
النموذج النموذجيqwen3-max or another available model ID

عادة ما تكشف امتدادات Kilo Code وVS Code على نمط Roo هذا كملف تعريف لتكوين API. تشير وثائق Roo Code العامة وإشعارات المنتجات إلى مسار shutdown/archive في 15 مايو 2026، لذا تفضل Cline أو Kilo Code لقوالب جديدة على مستوى الفريق ما لم يعتمد فريقك بالفعل على Roo.

سلوك مفاتيح API المخصصة في مؤشر المؤشرات يعتمد على الإصدار وسطح الميزة. إذا كان بناء المؤشر يقبل فقط مفاتيح واجهة برمجة التطبيقات للمزود ولا يكشف رابط أساسي مخصص للميزة التي تريدها، فلا يمكن توجيهه مباشرة إلى EmpirioLabs لتلك الميزة.

الاضطرابات

الرمزFix
401 Unauthorizedتحقق من المفتاح، تأكد من أنه يبدأ ب sk-empiriolabs-، وتحقق من أن الأداة ترسله كرمز حامل أو x-api-key.
402 Payment Requiredأضف إئتمانات في صفحة الإرسال
404 or model_not_foundإستعملْ GET /v1/models?available=true ونسخْ بالضبط id
(تول) يقول أن نقطة النهاية غير صحيحةإستعملْ https://api.empiriolabs.ai/v1 كقاعدةِ URL، لَيسَ كامل /chat/completions URL.
مكالمات العملاء ضعيفة أو متجاهلةاختر نموذجا يدعم tool/function-calling وتحقق من GET /v1/models/\{model_id\} للمعلمات المدعومة.
قانون كلود لا يظهر النموذجاضبط ANTHROPIC_CUSTOM_MODEL_OPTION وANTHROPIC_MODEL إلى معرف الطراز EmpirioLabs.
الفشل الحاد في عميلارجعوا مع مجرى المعاقين ثم تحققوا من الصفحة النموذجية لدعم البث

أبقوا العملاء معاقبين

عندما يقوم مساعد برمجة ذكاء اصطناعي بتنفيذ تكامل EmpirioLabs لك، أعطه أولا حزمة المستندات القابلة للقراءة الآلي:

أخبر الوكيل أن يستعمل https://docs.empiriolabs.ai/ai-agent-api-reference-context.md كمرجع للآداب، https://docs.empiriolabs.ai/ai-agent-docs-context.md لتفاصيل النموذج والتسعير، و GET https://api.empiriolabs.ai/v1/models/\{model_id\} لبيانات نموذجية حية.

هذا يمنع العميل من التخمين بتشكيلات نقطة النهاية، هويات نموذجية، أو أسماء بارامتر.