إنشاء رد نصي
استخدم واجهة برمجة تطبيقات الردود ShareAI لإنشاء نصوص بدون حالة، سجل محادثات صريح وأحداث بث الردود.
في هذه الصفحة
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
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_CHAT_MODEL', 'input': 'Explain semantic search in two sentences.', 'instructions': 'Use plain language.', 'store': False, 'stream': False}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/responses', 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/responses";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_CHAT_MODEL",
"input": "Explain semantic search in two sentences.",
"instructions": "Use plain language.",
"store": false,
"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());
حقول الطلب#
| الحقل | القيمة |
|---|---|
model | نموذج دردشة متاح ومسموح به بموجب بيانات اعتمادك. |
input | سلسلة غير فارغة، أو تصل إلى 256 رسالة نصية. |
instructions | تعليمات نظام اختيارية تُضاف إلى بداية المحادثة. |
store | false؛ تخزين الردود غير مدعوم. |
stream | false لـ 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