دليل التكامل البرمجي
توثيق واجهة 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 القياسية لتبسيط المعالجة.