مرجع سیاست ارائه‌دهنده

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

مشاهده به‌صورت Markdown

در این صفحه

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

فیلد	نوع	رفتار
`only`	آرایه‌ای از برچسب‌های ارائه‌دهنده	اجرای محدود به این ارائه‌دهندگان.
`ignore`	آرایه‌ای از برچسب‌های ارائه‌دهنده	این ارائه‌دهندگان را حذف کنید، از جمله از جایگزینی.
`order`	آرایه‌ای از برچسب‌های ارائه‌دهنده	این ارائه‌دهندگان را ابتدا در ترتیب ارائه‌شده رتبه‌بندی کنید؛ سپس مرتب‌سازی را اعمال کنید.
`allow_fallbacks`	بولین؛ پیش‌فرض true	اجازه به سایر ارائه‌دهندگان واجد شرایط. با false و یک لیست ترتیب غیرخالی، فقط ارائه‌دهندگان لیست‌شده باقی می‌مانند؛ بدون ترتیب، فقط ارائه‌دهنده‌ای که بالاترین رتبه را دارد باقی می‌ماند.
`networks`	آرایه	نوع‌های ارائه‌دهنده را به جامعه، شرکت و/یا shareai محدود کنید.
`sort`	رشته یا شیء	از قیمت، تأخیر یا توان عملیاتی استفاده کنید، یا یک شیء با by و جهت.

JSON

{
  "provider": {
    "ignore": [
      "PROVIDER_TO_EXCLUDE"
    ],
    "networks": [
      "company",
      "shareai"
    ],
    "sort": {
      "by": "throughput",
      "direction": "desc"
    },
    "allow_fallbacks": true
  }
}

جایگزین کردن جای‌نگهدار با یک برچسب ارائه‌دهنده واقعی کوچک، یا حذف فیلد ignore. نوع‌های شبکه دسته‌های زیرساخت را انتخاب می‌کنند؛ آن‌ها سازندگان مدل را شناسایی نمی‌کنند.

مرتب‌سازی پیش‌فرض‌ها#

مرتب‌سازی	جهت پیش‌فرض	معکوس صریح
`price`	`asc` — کمترین ابتدا	`desc` — بیشترین ابتدا
`latency`	`asc` — کوتاه‌ترین زمان سپری‌شده ابتدا	`desc` — طولانی‌ترین ابتدا
`throughput`	`desc` — بیشترین توکن‌های خروجی در هر ثانیه ابتدا	`asc` — کمترین ابتدا

برای یک شیء، تنظیم کنید by به یکی از این نام‌ها و direction به asc یا desc. مشاهده کنید نحوه کار اندازه‌گیری‌ها و جایگزینی.

اعتبارسنجی و خطاها#

از بولین‌های JSON و آرایه‌های برچسب‌های ارائه‌دهنده کوچک استفاده کنید. برای ارائه‌دهنده یا مرتب‌سازی، null ارسال نکنید.
فقط فیلدهای لیست‌شده پذیرفته می‌شوند؛ این یک پیاده‌سازی کامل پارامتر OpenRouter نیست.
سیاست به 8 کیلوبایت محدود است. لیست‌های only، ignore و order هر کدام حداکثر 100 برچسب را می‌پذیرند.
سیاست‌های نامعتبر HTTP 400 بازمی‌گردانند. محدوده‌های اعتبارنامه ممنوع HTTP 403 بازمی‌گردانند. عدم وجود ارائه‌دهنده واجد شرایط و موجود HTTP 503 بازمی‌گرداند.

یک سیاست حداقلی#

JSON

{
  "provider": {
    "sort": "price"
  }
}

وقتی کاملاً حذف شود، انتخاب ارائه‌دهنده نیز به رتبه‌بندی صعودی قیمت قطعی پیش‌فرض می‌شود. محدودیت‌ها همیشه قبل از رتبه‌بندی اعمال می‌شوند.

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