ShareAI Platform Docs

انتخاب ارائه‌دهندگان اجرا برای درخواست API

از شیء ارائه‌دهنده ShareAI برای انتخاب ارائه‌دهندگان اجرا به‌صورت مستقل از سازنده مدل در تمام چهار نقطه پایانی استنتاج استفاده کنید.

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

تنظیم کنید model به شناسه دقیق مبتنی بر سازنده. اضافه کنید provider زمانی که می‌خواهید زیرساخت واجد شرایط برای اجرای درخواست را محدود یا رتبه‌بندی کنید. حذف آن از سیاست پیش‌فرض صعودی قیمت استفاده می‌کند.

از یک ارائه‌دهنده استفاده کنید#

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 '{
  "provider": {
    "only": [
      "shareai"
    ],
    "allow_fallbacks": false
  },
  "model": "openai/gpt-5.4",
  "messages": [
    {
      "role": "user",
      "content": "Explain model routing in one sentence."
    }
  ]
}'

از برچسب‌های ارائه‌دهنده نشان‌داده‌شده برای مدل انتخاب‌شده استفاده کنید. only یک محدودیت سخت است: اجازه دادن به جایگزین‌ها هرگز ارائه‌دهنده‌ای خارج از این لیست را مجاز نمی‌کند.

از همان سیاست در هر نقطه پایانی استنتاج استفاده کنید#

نقطه پایانیفیلد ورودی اصلیمدلی را انتخاب کنید که از
/api/v1/chat/completionsmessagesتکمیل چت
/api/v1/responsesinputپاسخ‌ها
/api/v1/embeddingsinputجاسازی‌ها
/api/v1/images/generationspromptتولید تصویر

سیاست ارائه‌دهنده در این نقاط پایانی همان معنا را دارد. قابلیت‌های مدل و ارائه‌دهنده متفاوت است: یک مدل چت به‌طور خودکار مدل جاسازی یا تصویر نیست. یک شناسه واجد شرایط برای عملیات را از کاتالوگ کپی کنید؛ نقاط پایانی بومی نیاز به پشتیبانی پیکربندی‌شده دارند.

ارائه‌دهندگان نام‌گذاری‌شده را ترجیح دهید#

JSON

{
  "provider": {
    "order": [
      "PROVIDER_A",
      "PROVIDER_B"
    ],
    "allow_fallbacks": false,
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  }
}

جایگزین کنید PROVIDER_A و PROVIDER_B با برچسب‌های ارائه‌دهنده واقعی و کوچک. با این لیست مرتب‌شده و جایگزین‌ها غیرفعال، فقط ارائه‌دهندگان فهرست‌شده واجد شرایط هستند، به همان ترتیب. ارائه‌دهنده دوم همچنان می‌تواند انتخاب شود اگر اولی در دسترس نباشد.

محدودیت‌های اعتبارنامه را حفظ کنید#

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

بعدی#

هر فیلد ارائه‌دهنده · ترتیب مرتب‌سازی و رفتار جایگزین

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

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

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

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

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI