إنشاء إكمال دردشة
أرسل طلب إكمال محادثة ShareAI باستخدام مفتاح API Bearer وفهم النموذج المدعوم، الرسائل وحقول البث.
في هذه الصفحة
https://api.shareai.now/api/v1/chat/completionsقم بتشغيل طلب محادثة باستخدام النموذج المحدد.
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح API Bearer
هذا هو مسار التكامل الافتراضي للطلبات المدفوعة والمصرح بها بواسطة مساحة عمل مفتاح API الخاص بك. تنطبق قيود النموذج والمزود للمفتاح على التخصيص، بما في ذلك مسارات التراجع المسموح بها.
جسم الطلب#
| الحقل | النوع | المعنى |
|---|---|---|
model | سلسلة نصية، مطلوب | معرف النموذج المتاح بالضبط. انسخه من النماذج. |
messages | مصفوفة | رسائل المحادثة التي تحتوي على الدور والمحتوى. |
stream | منطقي | false يعيد نتيجة JSON واحدة؛ true يطلب أحداث مرسلة من الخادم. |
استخدم محتوى الرسائل النصية. أرسل أدوارًا مثل system, user و assistant حسب الاقتضاء للمحادثة. قم بتضمين تاريخ المحادثة الذي تريد أن يستخدمه النموذج؛ لا تفترض أن الطلبات تشترك في محادثة مخزنة.
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": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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': 'system', 'content': 'Be concise and helpful.'}, {'role': 'user', 'content': 'Give me three ideas for a local community event.'}], '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": "system",
"content": "Be concise and helpful."
},
{
"role": "user",
"content": "Give me three ideas for a local community event."
}
],
"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());
الاستجابة#
نتيجة مكتملة غير متدفقة تعيّن done إلى true وتعيد النص المُولد عند message.content. المستوى الأعلى يحمل أيضًا done_reason و consumption_type. يستخدم البث تنسيقًا مختلفًا، chat-completion-chunk. لا تفترض أن النتيجة غير المتدفقة تحتوي على مصفوفة خيارات بأسلوب OpenAI.
JSON
{
"done": true,
"done_reason": "stop",
"consumption_type": "credits",
"message": {
"role": "assistant",
"content": "Here are three ideas for your community event.",
"done": true,
"done_reason": "stop"
}
}
هذه نتيجة مكتملة توضيحية؛ يصف consumption_type وضع التخصيص الفعلي. تحقق من وجود خطأ على المستوى الأعلى حتى عندما تكون حالة HTTP هي 200. النتيجة بدون جهاز تستخدم حاليًا error.code = no_device مع HTTP 200.
قيود النموذج والمزود#
قد يكون المفتاح محدودًا لنماذج ومزودين تنفيذ محددين. إذا تم رفض الوصول، تحقق من معلومات المفتاح وقم بتحديث المفتاح في وحدة التحكم فقط إذا كانت مساحة العمل المالكة تنوي منح هذا الوصول.
البث أو تفويض العميل#
آخر تحديث سبتمبر 15, 2026