سنجاق گروه

هر مدل توسط یک یا چند گروه ارائه‌دهنده سرو می‌شود که هر یک قیمت خودش را دارد. به‌طور پیش‌فرض کلید از حالت auto استفاده می‌کند: هر درخواست به ارزان‌ترین گروه زنده می‌رود.

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

هر صفحه مدل همه گروه‌ها را با قیمت ورودی و خروجی زیر «قیمت‌گذاری گروهی» فهرست می‌کند. نشان تخفیف در فهرست مدل‌ها ارزان‌ترین گروه را نشان می‌دهد.

باز کنیدکلیدهای API، کلیدی بسازید یا ویرایش کنید و انتخابگر گروه را باز کنید. مدلی را جست‌وجو و کلیک کنید و یک یا چند گروه را — مرتب‌شده از ارزان‌ترین — تیک بزنید. مدل‌های دست‌نخورده روی auto می‌مانند.

مدل‌های سنجاق‌شده با نشان تعداد گروه‌هایشان به بالا مرتب می‌شوند. «Clear all» کلید را به auto برمی‌گرداند. فهرست کلیدها کلیدهای سنجاق‌شده را به‌صورت auto +N نشان می‌دهد.

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

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

حالت Automatic مدل را به زنجیره عادی ارزان‌ترین-اول برمی‌گرداند. بازه و سنجاق‌هایش ذخیره اما غیرفعال می‌مانند؛ پس خاموش‌کردنش دقیقاً همان پیکربندی قبلی را برمی‌گرداند.

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

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

برای سنجاق یک درخواست بدون تغییر کلید، هدر X-Group با نام دقیق گروه بفرستید. این، سنجاق کلید و مسیریابی خودکار را بازنویسی می‌کند. نام‌ها را از «قیمت‌گذاری گروهی» کپی کنید.

curl https://api.routerah.app/v1/chat/completions \
  -H "Authorization: Bearer $ROUTERAH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

هدر باید گروهی را نام ببرد که کلید مجاز به استفاده ازش باشد، وگرنه درخواست رد می‌شود. مدل‌های سنجاق‌نشده روی مسیریابی ارزان‌ترین می‌مانند.

اگر همه گروه‌های سنجاق‌شده قطع باشند در حالی که ارائه‌دهندگان دیگر مدل را سرو می‌کنند، درخواست‌ها با یک خطای مشخص — نه پیام عمومی شلوغی — شکست می‌خورند:

{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

سنجاق را بازتر یا بردارید، یا بعداً دوباره تلاش کنید. خودِ مدل بالا است.