ShareAI Platform Docs

یک تکمیل چت ایجاد کنید

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

مشاهده به‌صورت Markdown
در این صفحه
POST 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
}'

پاسخ#

یک نتیجه تکمیل‌شده غیرجریانی تنظیم می‌کند done به true و متن تولیدشده را در message.content. بازمی‌گرداند. سطح بالا همچنین شامل done_reason و consumption_type. است. جریان از یک فرمت متفاوت، قطعه تکمیل چت استفاده می‌کند. فرض نکنید نتیجه غیرجریانی دارای آرایه انتخاب‌های سبک 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 استفاده می‌کند.

محدودیت‌های مدل و ارائه‌دهنده#

یک کلید ممکن است به مدل‌ها و ارائه‌دهندگان اجرا خاص محدود شود. اگر دسترسی رد شد، اطلاعات کلید را بررسی کنید و کلید را در کنسول فقط در صورتی به‌روزرسانی کنید که فضای کاری مالک قصد اعطای آن دسترسی را داشته باشد.

جریان یا مجوز مشتری#

یک پاسخ را جریان دهید · از یک توکن دسترسی OAuth استفاده کنید

آخرین به‌روزرسانی سپتامبر 15, 2026

مستندات پلتفرم ShareAI
تمام مستندات

جستجو بر اساس عنوان یا محتوا.

درباره این صفحه بپرسید

یک دستیار برای کاوش این صفحه انتخاب کنید. همچنین می‌توانید صفحه را کپی کرده و در مکالمه خود جای‌گذاری کنید.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI