ShareAI Platform Docs

ایجاد یک پاسخ متنی

از API پاسخ‌های ShareAI برای تولید متن بدون حالت، تاریخچه مکالمه صریح و رویدادهای جریان پاسخ‌ها استفاده کنید.

مشاهده به‌صورت Markdown
در این صفحه
POST https://api.shareai.now/api/v1/responses

تولید یک پاسخ متنی از یک درخواست یا مکالمه.

URL پایه
https://api.shareai.now
احراز هویت
کلید API Bearer یا توکن دسترسی OAuth تأیید‌شده

این API را زمانی انتخاب کنید که برنامه شما از فرمت پیام متنی پاسخ‌ها استفاده می‌کند. مکالمه را در هر درخواست ارائه دهید؛ پاسخ‌ها برای بازیابی بعدی ذخیره نمی‌شوند.

ارسال یک درخواست#

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