وثائق الربط
يدعم 666 AI ثلاثة بروتوكولات شائعة. الأداة التي تستخدمها الآن ستعمل على الأرجح كما هي: غيّر عنواناً واحداً، والصق API Key واحداً، ولا تمسّ ما عداهما.
YOUR-ENDPOINT بعنوان الاتصال الخاص بك — تجده في الصفحة الرئيسية للوحة التحكم، أو دع دليل البداية يُنشئ الإعدادات نيابةً عنك.الربط في ثلاث خطوات
من التسجيل حتى نجاح أول طلب، عادةً أقل من ثلاث دقائق.
١. احصل على API Key
أنشئه من صفحة «API Key» في لوحة التحكم. ننصح بمفتاح مستقل لكل مشروع مع تحديد سقف للإنفاق.
٢. أدخل العنوان
https://YOUR-ENDPOINT/v1
٣. تحقّق من النتيجة
curl https://YOUR-ENDPOINT/v1/chat/completions \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"model":"deepseek-v4-flash", "messages":[{"role":"user","content":"hi"}]}' # A JSON response means it works
البروتوكولات المدعومة
مفتاح API Key واحد ورصيد واحد، وثلاثة بروتوكولات تختار بينها. لا حاجة لإعداد مفتاح مختلف لكل أداة.
صيغة OpenAI
مكتبة openai الرسمية تعمل كما هي؛ المتغيّر الوحيد هو base_url.
from openai import OpenAI client = OpenAI( api_key="YOUR_KEY", base_url="https://YOUR-ENDPOINT/v1" ) resp = client.chat.completions.create( model="deepseek-v4-flash", messages=[{"role": "user", "content": "你好"}] ) print(resp.choices[0].message.content)
import OpenAI from "openai"; const client = new OpenAI({ apiKey: "YOUR_KEY", baseURL: "https://YOUR-ENDPOINT/v1" }); const resp = await client.chat.completions.create({ model: "deepseek-v4-flash", messages: [{ role: "user", content: "你好" }] }); console.log(resp.choices[0].message.content);
صيغة Anthropic
إن كنت تستخدم Claude Code أو حزمة Anthropic الرسمية فاختر هذه الصيغة، فلا حاجة لأي تحويل. انتبه: هذا العنوان لا يتضمّن /v1.
# Add to ~/.zshrc or ~/.bashrc export ANTHROPIC_BASE_URL="https://YOUR-ENDPOINT" export ANTHROPIC_AUTH_TOKEN="YOUR_KEY" # Reopen the terminal, then just run claude
from anthropic import Anthropic client = Anthropic( api_key="YOUR_KEY", base_url="https://YOUR-ENDPOINT" ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "你好"}] ) print(msg.content[0].text)
صيغة Gemini
قيد التجهيز. وحتى ذلك الحين تبقى نماذج Gemini متاحة عبر صيغة OpenAI أعلاه، بالوظائف نفسها.
# Call Gemini like this curl https://YOUR-ENDPOINT/v1/chat/completions \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gemini-3.5-flash","messages":[{"role":"user","content":"hi"}]}'
المحرّرات والوكلاء
Cursor
- Settings → Models → OpenAI API Key
- فعّل Override Base URL
- أدخل العنوان و API Key ثم اضغط Verify
Claude Code
- اضبط ANTHROPIC_BASE_URL
- اضبط ANTHROPIC_AUTH_TOKEN
- أعد فتح الطرفية ثم شغّل claude
Cline / Roo Code
- اختر OpenAI Compatible في خانة Provider
- املأ Base URL و API Key
- ضع في Model ID المعرّف الوارد في الكتالوج
Continue
- عدّل ملف config.json
- اجعل provider هو openai
- أضف حقل apiBase
التطبيقات والإضافات
ChatBox / NextChat
- اختر OpenAI كخدمة للنماذج
- ضع عنوان البوابة في نطاق الـ API
- اكتب اسم النموذج يدوياً
Immersive Translate
- أضف واجهة ذكاء اصطناعي مخصّصة
- العنوان: /v1/chat/completions
- يُفضّل اختيار نموذج سريع ومنخفض التكلفة
Open WebUI
- الإعدادات ← الاتصالات الخارجية
- أضف اتصال OpenAI API
- أدخل العنوان و API Key ثم احفظ
أُطر التطوير
Dify
- اختر OpenAI-API-compatible كمزوّد للنماذج
- املأ API endpoint و API Key
- بقية إعدادات العقدة تبقى كما هي
n8n
- أنشئ بيانات اعتماد OpenAI جديدة
- ضع عنوان البوابة في Base URL
- اختر بيانات الاعتماد تلك داخل العقدة
LangChain
- استخدم ChatOpenAI
- مرّر base_url
- بقية السلسلة تبقى كما هي
البث / استدعاء الأدوات / الرؤية
تُستخدم هذه الثلاث تماماً كما في الواجهات الرسمية، دون تغيير أي معطى. ويعتمد توفّرها على النموذج نفسه، وهو مبيّن في كتالوج النماذج.
stream = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role":"user","content":"写一首诗"}],
stream=True
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")
تخزين المُوجّهات مؤقتاً
إذا كان كل طلب يحمل المقدّمة الطويلة نفسها — موجّه النظام، شيفرة المشروع، المستندات — فإن الجزء المخزَّن مؤقتاً يُحتسب بخصم كبير. والفائدة أوضح ما تكون في البرمجة وسيناريوهات الوكلاء.
رموز الأخطاء
| الرمز | المعنى | ما العمل |
|---|---|---|
401 | API Key غير صالح أو موقوف | تحقّق من نسخ الـ API Key كاملاً ومن أنه لم يُحذف |
402 | الرصيد غير كافٍ | اشحن الرصيد من لوحة التحكم |
404 | النموذج غير موجود | قارن المعرّف بكتالوج النماذج وتحقّق من هجائه |
429 | الطلبات متكرّرة أكثر من اللازم | قلّل عدد الطلبات المتزامنة، أو أعد المحاولة بعد قليل |
500 | خلل لدى المزوّد | تعيد البوابة المحاولة تلقائياً عبر مسار احتياطي. راسلنا إن استمرّ الخطأ |
الحصص وحدود المعدّل
يمكن لكل API Key أن يكون له سقف إنفاق ونطاق نماذج خاص به. خصّص مفتاحاً لكل مشروع: عندها إذا تسرّب أحدها تبقى الخسارة محدودة، ويكفي حذفه وإنشاء غيره.