Softelv AI Logo Softelv AI
دليل التكامل البرمجي

توثيق واجهة Softelv AI
بديل OpenAI فائق السرعة

جميع نقاط الاتصال متوافقة 100% مع مواصفات Chat Completions القياسية. ما عليك سوى تغيير base_url ومفتاح الـ API للبدء فوراً.

إعدادات الاتصال الأساسية

استخدم معايير المصادقة القياسية (Bearer Token) للتواصل مع السحابة.

نقطة النهاية الأساسية

Base URL

النطاق السحابي المعتمد لجميع طلبات REST و SSE:

https://softelv.ai/v1
المصادقة والأمان

Authentication

يتم إرسال المفتاح في ترويسة الطلب القياسية:

Authorization: Bearer sk-nashmi-...

أمثلة سريعة للبدء

استخدم نفس المكتبات التي تستخدمها مع OpenAI دون أي تعديل هيكلي على كودك.

1. بايثون (Python OpenAI SDK)

تثبيت: pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://softelv.ai/v1",
    api_key="sk-nashmi-your-api-key"
)

stream = client.chat.completions.create(
    model="llama-3.3-70b",
    messages=[
        {"role": "system", "content": "أنت مساعد برمجي خبير ومتحدث باللغة العربية."},
        {"role": "user", "content": "اشرح الفرق بين REST و GraphQL في جملتين."}
    ],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content or ""
    print(content, end="", flush=True)

2. نود جي إس (Node.js / TypeScript)

تثبيت: npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://softelv.ai/v1",
  apiKey: "sk-nashmi-your-api-key"
});

async function run() {
  const completion = await client.chat.completions.create({
    model: "deepseek-r1",
    messages: [{ role: "user", content: "حلّل المسألة التالية منطقياً..." }]
  });

  console.log(completion.choices[0].message.content);
}

run();

3. طلب مباشر عبر cURL

جاهز للاستخدام من سطر الأوامر أو من أي لغة برمجة تدعم طلبات HTTP.

curl -X POST https://softelv.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-nashmi-your-api-key" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [{"role": "user", "content": "مرحبا بك يا نشمي"}],
    "temperature": 0.7
  }'

توليد الصور بالذكاء الاصطناعي (FLUX.1 Schnell)

واجهة مخصصة لتوليد الصور عالية الدقة في أقل من ثانيتين مع دعم فوري للنصوص باللغة العربية.

curl -X POST https://softelv.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-nashmi-your-api-key" \
  -d '{
    "prompt": "صورة سينمائية لقلعة عمان وقت الغروب بأنوار دافئة وأفق المدينة القديمة",
    "model": "flux-1-schnell",
    "size": "1024x1024"
  }'

رموز الاستجابة ومعالجة الأخطاء

تتبع واجهة Softelv AI معايير HTTP القياسية لتبسيط المعالجة.

رمز HTTP المعنى الإجراء المقترح
200 OK تم تنفيذ الطلب بنجاح. معالجة كائن الاستجابة أو تدفق الـ SSE.
401 Unauthorized مفتاح API مفقود أو غير صالح. تأكد من ترويسة Authorization: Bearer sk-....
404 Not Found النموذج المطلوب غير متاح أو المسار خاطئ. راجع كتالوج النماذج المعتمدة.
429 Too Many Requests تجاوز حد الطلبات المسموح (Rate Limit). فعّل Exponential Backoff أو قم بترقية باقتك إلى خطة Pro.
500 Internal Error خطأ غير متوقع في محرك المعالجة السحابي. إعادة المحاولة تلقائياً بعد ثانية واحدة.