Documentation

وثائق الربط

يدعم 666 AI ثلاثة بروتوكولات شائعة. الأداة التي تستخدمها الآن ستعمل على الأرجح كما هي: غيّر عنواناً واحداً، والصق API Key واحداً، ولا تمسّ ما عداهما.

في الأمثلة أدناه، استبدل YOUR-ENDPOINT بعنوان الاتصال الخاص بك — تجده في الصفحة الرئيسية للوحة التحكم، أو دع دليل البداية يُنشئ الإعدادات نيابةً عنك.

الربط في ثلاث خطوات

من التسجيل حتى نجاح أول طلب، عادةً أقل من ثلاث دقائق.

١. احصل على API Key

أنشئه من صفحة «API Key» في لوحة التحكم. ننصح بمفتاح مستقل لكل مشروع مع تحديد سقف للإنفاق.

٢. أدخل العنوان

BASE URL
https://YOUR-ENDPOINT/v1

٣. تحقّق من النتيجة

curl
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
الأكثر انتشاراً. تدعمه معظم الأدوات وحِزم التطوير افتراضياً.
/v1/chat/completions
متاح
Anthropic
الصيغة الأصلية لـ Claude Code و Cline، دون أي طبقة تحويل.
/v1/messages
قيد التجهيز
Gemini
الصيغة الأصلية من Google، وتناسب المشاريع المكتوبة أصلاً لـ Gemini.
/v1beta/models
محتار؟ اختر صيغة OpenAI: توافقها هو الأوسع، وتغيير النموذج لا يستدعي تعديل الشيفرة.

صيغة OpenAI

مكتبة openai الرسمية تعمل كما هي؛ المتغيّر الوحيد هو base_url.

Python
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)
Node.js
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‎.

Claude Code
# 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
Python SDK
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 أعلاه، بالوظائف نفسها.

curl
# 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

  1. Settings → Models → OpenAI API Key
  2. فعّل Override Base URL
  3. أدخل العنوان و API Key ثم اضغط Verify

Claude Code

  1. اضبط ANTHROPIC_BASE_URL
  2. اضبط ANTHROPIC_AUTH_TOKEN
  3. أعد فتح الطرفية ثم شغّل claude

Cline / Roo Code

  1. اختر OpenAI Compatible في خانة Provider
  2. املأ Base URL و API Key
  3. ضع في Model ID المعرّف الوارد في الكتالوج

Continue

  1. عدّل ملف config.json
  2. اجعل provider هو openai
  3. أضف حقل apiBase

التطبيقات والإضافات

ChatBox / NextChat

  1. اختر OpenAI كخدمة للنماذج
  2. ضع عنوان البوابة في نطاق الـ API
  3. اكتب اسم النموذج يدوياً

Immersive Translate

  1. أضف واجهة ذكاء اصطناعي مخصّصة
  2. العنوان: /v1/chat/completions
  3. يُفضّل اختيار نموذج سريع ومنخفض التكلفة

Open WebUI

  1. الإعدادات ← الاتصالات الخارجية
  2. أضف اتصال OpenAI API
  3. أدخل العنوان و API Key ثم احفظ

أُطر التطوير

Dify

  1. اختر OpenAI-API-compatible كمزوّد للنماذج
  2. املأ API endpoint و API Key
  3. بقية إعدادات العقدة تبقى كما هي

n8n

  1. أنشئ بيانات اعتماد OpenAI جديدة
  2. ضع عنوان البوابة في Base URL
  3. اختر بيانات الاعتماد تلك داخل العقدة

LangChain

  1. استخدم ChatOpenAI
  2. مرّر base_url
  3. بقية السلسلة تبقى كما هي

البث / استدعاء الأدوات / الرؤية

تُستخدم هذه الثلاث تماماً كما في الواجهات الرسمية، دون تغيير أي معطى. ويعتمد توفّرها على النموذج نفسه، وهو مبيّن في كتالوج النماذج.

إخراج متدفّق
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 أن يكون له سقف إنفاق ونطاق نماذج خاص به. خصّص مفتاحاً لكل مشروع: عندها إذا تسرّب أحدها تبقى الخسارة محدودة، ويكفي حذفه وإنشاء غيره.

الطلبات الفاشلة لا تُحتسب. ولا تدخل حالات انتهاء المهلة ولا أخطاء المزوّد في فاتورتك.
←