ShareAI Platform Docs

اولین درخواست API خود را ارسال کنید

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

مشاهده به‌صورت Markdown
در این صفحه

از اینجا شروع کنید زمانی که برنامه شما درخواست‌ها را با استفاده از یک کلید API از فضای کاری ShareAI خودتان ارسال خواهد کرد. شما به یک حساب ShareAI، یک کلید فعال و دسترسی به مدلی که می‌خواهید اجرا کنید نیاز دارید.

1. ایجاد یک کلید API#

باز کردن کنسول ShareAI و فضای کاری را انتخاب کنید که مالک کلید و استفاده خواهد بود. باز کنید کلیدهای API, ، انتخاب کنید ایجاد کلید API، به کلید یک نام قابل تشخیص بدهید و راز را در محیط سرور خود ذخیره کنید.

ایجاد و مدیریت اعتبارنامه‌های استنتاج از کلیدهای API.ایجاد و مدیریت اعتبارنامه‌های استنتاج از کلیدهای API.
ایجاد و مدیریت اعتبارنامه‌های استنتاج از کلیدهای API.

2. انتخاب یک مدل#

باز کردن مدل‌ها و شناسه دقیق مدل نمایش داده شده در آنجا را کپی کنید. دسترسی فعلی و محدودیت‌های مدل/ارائه‌دهنده روی کلید خود را بررسی کنید. یک شناسه در یک آموزش قدیمی تضمین نمی‌کند که ظرفیت امروز در دسترس باشد.

3. ارسال درخواست#

POST https://api.shareai.now/api/v1/chat/completions

با استفاده از یک مدل موجود، یک پاسخ تولید کنید.

URL پایه
https://api.shareai.now
احراز هویت
کلید API Bearer

جایگزین کنید MODEL_IDENTIFIER با شناسه انتخابی خود. تنظیم کنید SHAREAI_API_KEY در محیط خود قبل از اجرای مثال.

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": "user",
      "content": "Explain what ShareAI does in one sentence."
    }
  ],
  "stream": false
}'

4. خواندن نتیجه#

برای یک درخواست موفقیت‌آمیز غیرجریانی، بررسی کنید که done برابر با true باشد و پیام دستیار را از message.content. بخوانید. هم وضعیت HTTP و هم هر شیء خطا در بدنه را بررسی کنید قبل از اینکه آن را به‌عنوان یک تکمیل موفقیت‌آمیز در نظر بگیرید. نتیجه بدون دستگاه ممکن است در حال حاضر به‌صورت یک شیء خطا با HTTP 200 ارائه شود.

اگر درخواست شکست خورد#

وضعیتمرحله بعد
401کلید، فضای کاری و هدر Authorization را بررسی کنید.
402اعتبارهای موجود یا موجودی قابل اعمال را بررسی کنید.
403مدل‌ها و ارائه‌دهندگان مجاز را بررسی کنید.
429در صورت وجود Retry-After منتظر بمانید، سپس با تأخیر محدود دوباره تلاش کنید.
503ظرفیت فعلی یا دسترسی به خدمات را بررسی کنید؛ محدودیت تلاش را حفظ کنید.

مراحل بعدی#

مرجع درخواست و پاسخ چت بدنه پشتیبانی‌شده را توضیح می‌دهد. اگر هر مشتری باید حساب خود را تأیید کند، دنبال کنید OAuth برنامه.

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

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI