مدل‌ها

هر دستیار روی یک مدل اجرا می‌شود که در فیلد model آن تعیین می‌شود (دستیارها را ببینید). فهرست مدل‌ها داخل پلکسیت مدیریت می‌شود، بر اساس شرکت دسته‌بندی شده و در طول زمان بیشتر می‌شود؛ برای همین این صفحه آن را ثابت ننوشته و جدول پایین به‌صورت زنده خوانده می‌شود.

دریافت فهرست مدل‌ها


GET /v1/models

نیاز به Authorization: Bearer <raw_key> دارد. همه‌ی مدل‌های منتشرشده را شرکت‌به‌شرکت و به ترتیب نمایش برمی‌گرداند و می‌گوید حساب شما با هر کدام چه کاری می‌تواند بکند.

پاسخ 200


{
  "data": {
    "list": [
      {
        "key": "sol",
        "name": "Sol",
        "company": { "slug": "plexit", "title": "Plexit" },
        "description": "مدل متعادل برای پشتیبانی روزمره.",
        "supportedReasoning": ["low", "medium", "high"],
        "available": true,
        "allowed": true,
        "usable": true
      },
      {
        "key": "claude-sonnet",
        "name": "Claude Sonnet",
        "company": { "slug": "anthropic", "title": "Anthropic" },
        "description": null,
        "supportedReasoning": null,
        "available": false,
        "allowed": true,
        "usable": false
      }
    ],
    "count": 2
  },
  "response": { "status": "success", "message": "..." }
}

فیلد	نوع	توضیح
`key`	`string`	مقداری که به‌عنوان `model` دستیار ذخیره می‌کنید و در پاسخ گفتگو هم به‌صورت `model` برمی‌گردد.
`name`	`string`	نام نمایشی.
`company`	`{ slug, title }`	شرکتی که مدل به آن تعلق دارد. شرکت‌های تازه هر زمان ممکن است اضافه شوند؛ پس بر اساس `slug` گروه‌بندی کنید و مجموعه‌ی ثابتی فرض نکنید.
`description`	`string \| null`
`supportedReasoning`	`string[] \| null`	سطح‌های reasoning (`none`، `low`، `medium`، `high`) که مدل می‌پذیرد. `null` یعنی همه. مدلی که نمی‌تواند تفکر را خاموش کند (مثل Claude) از `low` به بالا دارد؛ دستیاری که روی چنین مدلی با `none` ذخیره شده با پایین‌ترین سطح همان مدل اجرا می‌شود.
`available`	`boolean`	وقتی `true` است که سرویس گفتگو همین حالا بتواند مدل را اجرا کند. مدلی که منتشر شده ولی هنوز اجرا نمی‌شود `false` است («به‌زودی»).
`allowed`	`boolean`	وقتی `true` است که پلن شما مدل را شامل شود.
`usable`	`boolean`	یعنی `available && allowed`. فقط همین‌ها را می‌شود برای دستیار انتخاب کرد و سرو گرفت.

پاسخ ۶۰ ثانیه قابل کش است (Cache-Control: private, max-age=60). نام مدلِ سرویس‌دهنده‌ی بالادستی یا هیچ قیمتی در آن نمایش داده نمی‌شود.

انتخاب مدل برای دستیار

یک key با usable برابر true انتخاب کنید. در کنسول هم همین فهرست انتخابگر مدل را می‌سازد و مدلی که available نیست به‌جای پنهان شدن، غیرفعال و با برچسب «به‌زودی» نشان داده می‌شود.

مدلِ منتشرشده‌ای که available نیست نمی‌تواند پاسخ گفتگو بدهد. اگر دستیاری روی چنین مدلی مانده باشد، POST /v1/assistants/:assistantCode/chat با کد 503 و response.code برابر chat.model_unavailable جواب می‌دهد. دستیار را روی یک مدل usable بگذارید و دوباره تلاش کنید.

مدل‌های منتشرشده

همین فهرست بدون کلید API (صفحه‌ی قیمت‌ها هم از آن استفاده می‌کند). مدل‌هایی که «به‌زودی» نوشته شده‌اند اعلام شده‌اند ولی هنوز قابل انتخاب نیستند.

فهرست زنده‌ی مدل‌ها در این لحظه بارگذاری نشد. همین فهرست را با کلید API خودتان از `GET /v1/models` بگیرید.