قم بإجراء أول طلب لواجهة برمجة التطبيقات
قم بإنشاء مفتاح API لـ ShareAI، اختر نموذجًا متاحًا وأرسل طلب دردشة من خادمك باستخدام مصادقة Bearer.
في هذه الصفحة
ابدأ هنا عندما تقوم تطبيقك بإرسال طلبات باستخدام مفتاح API من مساحة العمل الخاصة بك في ShareAI. تحتاج إلى حساب ShareAI، مفتاح نشط والوصول إلى النموذج الذي تريد تشغيله.
1. إنشاء مفتاح API#
فتح وحدة تحكم ShareAI واختر مساحة العمل التي ستملك المفتاح والاستخدام. افتح مفاتيح API, ، اختر إنشاء مفتاح API، أعط المفتاح اسمًا يمكن التعرف عليه واحفظ السر في بيئة الخادم الخاص بك.


2. اختيار نموذج#
فتح النماذج ونسخ معرف النموذج الدقيق المعروض هناك. تحقق من التوفر الحالي وقيود النموذج/المزود على مفتاحك. معرف في دليل قديم لا يضمن أن السعة متاحة اليوم.
3. إرسال الطلب#
https://api.shareai.now/api/v1/chat/completionsقم بإنشاء استجابة باستخدام نموذج متاح.
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح API Bearer
استبدل MODEL_IDENTIFIER باستخدام المعرف الذي اخترته. قم بتعيين SHAREAI_API_KEY في بيئتك قبل تشغيل المثال.
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/chat/completions" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'MODEL_IDENTIFIER', 'messages': [{'role': 'user', 'content': 'Explain what ShareAI does in one sentence.'}], 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/chat/completions', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/chat/completions";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "MODEL_IDENTIFIER",
"messages": [
{
"role": "user",
"content": "Explain what ShareAI does in one sentence."
}
],
"stream": false
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
4. قراءة النتيجة#
لطلب ناجح غير متدفق، تحقق من أن done صحيح واقرأ رسالة المساعد من message.content. تحقق من حالة HTTP وأي كائن خطأ في الجسم قبل اعتباره إكمالًا ناجحًا. يمكن أن تصل نتيجة عدم وجود جهاز حاليًا ككائن خطأ مع HTTP 200.
إذا فشل الطلب#
| الحالة | الخطوة التالية |
|---|---|
| 401 | تحقق من المفتاح، مساحة العمل ورأس Authorization. |
| 402 | تحقق من الرصيد المتاح أو الرصيد القابل للتطبيق. |
| 403 | تحقق من النماذج والمزودين المسموح بهم. |
| 429 | انتظر Retry-After عند وجوده، ثم حاول مرة أخرى مع تأخير محدود. |
| 503 | تحقق من السعة الحالية أو توفر الخدمة؛ احتفظ بحد إعادة المحاولة. |
الخطوات التالية#
مرجع طلب واستجابة الدردشة يشرح الجسم المدعوم. إذا كان يجب على كل عميل أن يصرح حسابه الخاص، اتبع OAuth للتطبيق.
آخر تحديث سبتمبر 15, 2026