ابدأ بسرعة مع 4-4 AI: اتصل بواجهة AI موحدة في 5 دقائق
يرشدك هذا الدرس من الصفر إلى الاتصال الكامل بـ 4-4 AI: احصل على المفتاح ← اضبط Base URL ← شغّل أول مخرجات متدفقة. كل ذلك عبر الواجهة المتوافقة مع OpenAI — أي كود أو إطار عمل أو أداة لديك تدعم Base URL مخصصًا (openai SDK وLangChain وCursor وغيرها) لا يحتاج تغييرًا في منطق الكود، التغيير في الإعدادات فقط.
التحضير المسبق
- قم بزيارة www.4-4.vip وسجّل حسابًا ثم ادخل إلى لوحة التحكم؛
- اشحن رصيدًا من لوحة التحكم أو استبدل رمز بطاقة؛
- في صفحة «الرموز (Tokens)» أنشئ مفتاح API جديدًا (بصيغة
sk-...) واحفظه بعناية — لا يظهر كاملًا إلا مرة واحدة عند إنشائه.
المفهوم الأساسي: Base URL والمفتاح
توفر 4-4 AI بروتوكول واجهة متوافقًا تمامًا مع OpenAI. ما عليك تذكره إعدادان فقط:
| عنصر الإعداد | القيمة |
|---|---|
| Base URL | https://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);
ربط أطر العمل والأدوات الرئيسية
- LangChain / LlamaIndex: استخدم مكوناتها المتوافقة مع OpenAI واضبط
base_url/openai_api_baseعلى العنوان أعلاه فقط؛ - Cursor / Claude Code / Cherry Studio وأدوات AI الأخرى: أدخل Base URL والمفتاح في إعدادات «API مخصص / متوافق مع OpenAI»؛
- البرامج المطوَّرة ذاتيًا: أي عميل HTTP ملتزم ببروتوكول OpenAI يتصل مباشرة، دون حاجة إلى SDK إضافي.
الأسئلة الشائعة (FAQ)
خطأ 401 Invalid API Key؟
تحقق بالترتيب: ① هل دخلت مسافات أو فواصل أسطر مع المفتاح عند النسخ؛ ② هل المفتاح معطَّل أو محذوف في قائمة الرموز بلوحة التحكم؛ ③ هل رصيد الحساب نُفد؛ ④ هل ترويسة Authorization بصيغة Bearer sk-... (انتبه للمسافة بعد Bearer).
خطأ 429، طلبات كثيرة جدًا؟
تفرض البوابة حدًا للمعدل على كل رمز. خفّف التوازي، وأطل مدة التراجع بين المحاولات (تراجع أسّي مع اهتزاز عشوائي مستحسن)، أو ارفع حد المعدل للرمز من لوحة التحكم.
المخرجات المتدفقة تنقطع في المنتصف؟
للردود الطويلة يُستحسن تمكين إعادة المحاولة عند انتهاء المهلة في الـ SDK؛ إن كنت تمر عبر بروكسي الشركة فتأكد أنه لا يخزّن تدفق SSE (text/event-stream) مؤقتًا.
أي النماذج مدعومة؟
المرجع هو القائمة اللحظية في صفحة «النماذج» بلوحة التحكم. تدمج 4-4 AI نماذج GLM وDeepSeek وQwen وغيرها من النماذج الرئيسية: المفتاح نفسه والواجهة نفسها، وتبديل النموذج يصبح ممكنًا.
مقالات ذات صلة
مفتاح واحد للاتصال الموحد بنماذج GLM وDeepSeek وQwen وغيرها: فوترة موحدة واستخدام مرئي.
عرض النماذج والأسعار جرّب مجانًا