ابدأ بسرعة مع 4-4 AI: اتصل بواجهة AI موحدة في 5 دقائق

درس تعليمي · 2026-11-20 · 8 دقائق قراءة

يرشدك هذا الدرس من الصفر إلى الاتصال الكامل بـ 4-4 AI: احصل على المفتاح ← اضبط Base URL ← شغّل أول مخرجات متدفقة. كل ذلك عبر الواجهة المتوافقة مع OpenAI — أي كود أو إطار عمل أو أداة لديك تدعم Base URL مخصصًا (openai SDK وLangChain وCursor وغيرها) لا يحتاج تغييرًا في منطق الكود، التغيير في الإعدادات فقط.

التحضير المسبق

  1. قم بزيارة www.4-4.vip وسجّل حسابًا ثم ادخل إلى لوحة التحكم؛
  2. اشحن رصيدًا من لوحة التحكم أو استبدل رمز بطاقة؛
  3. في صفحة «الرموز (Tokens)» أنشئ مفتاح API جديدًا (بصيغة sk-...) واحفظه بعناية — لا يظهر كاملًا إلا مرة واحدة عند إنشائه.
تنبيه أمني: مفتاح API يعادل رصيد الحساب. لا ترفعه إلى مستودعات Git أو كود الواجهة الأمامية. يُستحسن إدارته عبر متغيرات البيئة.

المفهوم الأساسي: Base URL والمفتاح

توفر 4-4 AI بروتوكول واجهة متوافقًا تمامًا مع OpenAI. ما عليك تذكره إعدادان فقط:

عنصر الإعدادالقيمة
Base URLhttps://www.4-4.vip/v1
API Keyالمفتاح sk-... المُنشأ في صفحة الرموز بلوحة التحكم
معامل modelحدد اسم النموذج حسب الحاجة، مثل deepseek-chat وglm-4 وغيرها (المرجع قائمة النماذج في لوحة التحكم)

تغيير النموذج = تغيير معامل model فقط؛ تغيير المزود = تغيير Base URL فقط. هذه هي القيمة الجوهرية للبوابة الموحدة: فصل كود العمل عن مزود النماذج.

الطريقة 1: cURL (أسرع وسيلة للتحقق من الاتصال)

curl https://www.4-4.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $44AI_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence"}
    ]
  }'

إذا احتوى JSON المُرجَع على choices[0].message.content فالسلسلة كلها تعمل.

الطريقة 2: Python (SDK openai الرسمي)

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["44AI_API_KEY"],          # your 4-4 AI key
    base_url="https://www.4-4.vip/v1"            # key: point to the 4-4 AI gateway
)

# regular call
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)

# streaming output
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if delta and delta.content:
        print(delta.content, end="", flush=True)

الطريقة 3: Node.js

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.N44_API_KEY,
  baseURL: "https://www.4-4.vip/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);

ربط أطر العمل والأدوات الرئيسية

الأسئلة الشائعة (FAQ)

خطأ 401 Invalid API Key؟

تحقق بالترتيب: ① هل دخلت مسافات أو فواصل أسطر مع المفتاح عند النسخ؛ ② هل المفتاح معطَّل أو محذوف في قائمة الرموز بلوحة التحكم؛ ③ هل رصيد الحساب نُفد؛ ④ هل ترويسة Authorization بصيغة Bearer sk-... (انتبه للمسافة بعد Bearer).

خطأ 429، طلبات كثيرة جدًا؟

تفرض البوابة حدًا للمعدل على كل رمز. خفّف التوازي، وأطل مدة التراجع بين المحاولات (تراجع أسّي مع اهتزاز عشوائي مستحسن)، أو ارفع حد المعدل للرمز من لوحة التحكم.

المخرجات المتدفقة تنقطع في المنتصف؟

للردود الطويلة يُستحسن تمكين إعادة المحاولة عند انتهاء المهلة في الـ SDK؛ إن كنت تمر عبر بروكسي الشركة فتأكد أنه لا يخزّن تدفق SSE (text/event-stream) مؤقتًا.

أي النماذج مدعومة؟

المرجع هو القائمة اللحظية في صفحة «النماذج» بلوحة التحكم. تدمج 4-4 AI نماذج GLM وDeepSeek وQwen وغيرها من النماذج الرئيسية: المفتاح نفسه والواجهة نفسها، وتبديل النموذج يصبح ممكنًا.

مقالات ذات صلة

one-api / new-api ذاتية الاستضافة مقابل بوابة AI مُدارة: التكلفة والتشغيل والأمان إطار قرار صريح للفرق المترددة بين «البناء أو الشراء»: التكاليف التشغيلية الخفية، ومقارنة سيناريوهات الأعطال، و ربط Cursor / Claude Code / Cherry Studio ببوابة AI مخصصة طريقة إعداد Base URL مخصص لأشهر أدوات البرمجة والمحادثة بالذكاء الاصطناعي، مع دليل سريع لأخطاء 401 / 404 / الن
هل أنت مستعد للاتصال؟

مفتاح واحد للاتصال الموحد بنماذج GLM وDeepSeek وQwen وغيرها: فوترة موحدة واستخدام مرئي.

عرض النماذج والأسعار جرّب مجانًا