ShareAI Platform Docs

إنشاء رد نصي

استخدم واجهة برمجة تطبيقات الردود ShareAI لإنشاء نصوص بدون حالة، سجل محادثات صريح وأحداث بث الردود.

عرض كـ Markdown
في هذه الصفحة
POST https://api.shareai.now/api/v1/responses

إنشاء رد نصي من مطالبة أو محادثة.

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد

اختر هذه الواجهة عندما يستخدم تطبيقك تنسيق رسائل النصوص للردود. قم بتزويد المحادثة في كل طلب؛ الردود لا يتم تخزينها للاسترجاع لاحقًا.

إرسال طلب#

cURL

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/responses" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_CHAT_MODEL",
  "input": "Explain semantic search in two sentences.",
  "instructions": "Use plain language.",
  "store": false,
  "stream": false
}'

حقول الطلب#

الحقلالقيمة
modelنموذج دردشة متاح ومسموح به بموجب بيانات اعتمادك.
inputسلسلة غير فارغة، أو تصل إلى 256 رسالة نصية.
instructionsتعليمات نظام اختيارية تُضاف إلى بداية المحادثة.
storefalse؛ تخزين الردود غير مدعوم.
streamfalse لـ JSON أو true لأحداث بث الردود SSE.

متابعة محادثة#

أرسل الرسائل السابقة في input جنبًا إلى جنب مع رسالة المستخدم التالية. الأدوار المدعومة هي user, assistant, system و developer. تعليمات المطورين تستخدم دور النظام داخليًا. يمكن أن يكون محتوى الرسالة نصًا أو input_text/output_text أجزاء.

JSON

{
  "model": "YOUR_CHAT_MODEL",
  "input": [
    {
      "role": "user",
      "content": "What is semantic search?"
    },
    {
      "role": "assistant",
      "content": "It finds results by meaning rather than exact words."
    },
    {
      "role": "user",
      "content": "Give one example."
    }
  ],
  "store": false
}

قراءة النتيجة#

الرد JSON هو response كائن. اقرأ النص المساعد من output[].content[] الإدخالات ذات النوع output_text. تحقق من حالة الرد: completed هو رد مكتمل؛ incomplete يمكن أن يشير إلى حد الرموز. العامة usage حاليًا null؛ استخدم استخدام وحدة التحكم لفحص الاستخدام المعالج.

بث استجابة#

قم بتعيين stream: true وتحليل SSE. تتضمن الأحداث response.created, response.output_text.delta وحالة نهائية response.completed, response.incomplete أو response.failed. أضف دلتا النصوص بالترتيب وتعامل مع الحالة النهائية بشكل صريح.

مجموعة فرعية مدعومة#

يدعم هذا المنفذ إنشاء النصوص. الردود المخزنة، previous_response_id، الاسترجاع/الحذف، الأدوات، إدخال الصور، الطلبات الخلفية وإعدادات الإنشاء مثل temperature غير مدعومة ومرفوضة. لاستخدام إعدادات إنشاء الرسائل المدعومة بواسطة Chat Completions، استخدم إكمالات الدردشة.

استخدم رمز وصول OAuth#

استبدل مفتاح API في رأس Authorization برمز وصول OAuth معتمد. الـ surcharge النطاق وخطة الاستخدام المقبولة مطلوبان للاستدلال الممول من الحساب. النطاقات الخاصة بالهوية فقط لا تخول الإنفاق. انظر النطاقات والأذونات.

آخر تحديث سبتمبر 15, 2026

مستندات منصة ShareAI
جميع المستندات

البحث حسب العنوان أو المحتوى.

اسأل عن هذه الصفحة

اختر مساعدًا لاستكشاف هذه الصفحة. يمكنك أيضًا نسخ الصفحة ولصقها في محادثتك.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI