تغییرات API
تاریخچهٔ قرارداد عمومی ساروی.
نسخهٔ ۱٫۶ — قابلیتهای Messages
- thinking و امضاهای آن، prompt caching و شمارندههای مصرف کش، تصویر و PDF همراه با ارجاع.
- ابزارهای میزبانیشدهٔ جستجو، دریافت صفحه و اجرای Bash؛ computer use با اجرای عمل در برنامهٔ شما.
- پردازش گروهی Messages با فهرست، صفحهبندی، لغو و دریافت نتایج JSONL؛ با نرخ معمول ساروی.
- نمونههای تعاملی در صفحهٔ اصلی و سادهتر شدن ساخت کلید.
- شمارش دقیق توکن فعلاً در دسترس نیست؛ count_tokens خطای 503 میدهد و اعتباری مصرف نمیکند. جزئیات در راهنمای سازگاری.
نسخهٔ ۱٫۵ — تجربهٔ توسعهدهندگان
- مرکز توسعهدهندگان و مستندات با مسیر شروع روشن، جستجوی متن راهنما و مرجع قابل مرور.
- راهنمای نصب و بستههای پیشنمایش Python و TypeScript؛ انتشار عمومی در npm و PyPI هنوز انجام نشده است.
- مسیر آزمایشی /v1/messages برای متن، ابزارهای function و استریم در قالب Anthropic. ویژگیهای پشتیبانینشده پیش از اجرا رد میشوند.
- قرارداد پاسخهای اصلی و جدول سازگاری OpenAI و Anthropic.
بهروزرسانی ۱۳ سپتامبر — Cloud Starter و استدلال
- ابر اشتراکی رایگان با داده، ورود کاربران، فایل خصوصی، تابع و انتشار سایت HTTPS.
- سهمیههای روشن، جداسازی دادهٔ برنامهها و کاربران و بدون ارتقای پولی خودکار.
- نمایش اختیاری استدلال یا خلاصهٔ ارائهدهنده در API و آزمایشگاه با include_reasoning.
- نوار کناری سمت چپ، راهنمای موبایل و انتخاب پایدار پروژه.
- نمونههای Python، JavaScript و cURL برای مسیرهای برنامه و مدیریت.
نسخهٔ v1 — سپتامبر ۲۰۲۶
- کنسول فارسی توسعهدهندگان با پروژه، کلید، آزمایشگاه، مصرف و گزارش.
- کلیدهای هششده با دسترسی، انقضا، لغو، محدودیت نرخ و سقف اعتبار.
- Responses با مدلهای گفتگویی ساروی، تاریخچهٔ پیام و SSE.
- Studio برای متن، تصویر، صدا و ویدیو با اعتبار مشترک.
- تعریف و اجرای عامل، Work ماندگار و دریافت فایل.
- ورود با حساب موجود و استفاده از خرید اعتبار فعلی.
- صفحهٔ مستقل مدلها، مرجع OpenAPI، نمونههای Python و JavaScript.
قراردادهای فعلی
محدودیت و رفتار دقیق هر قابلیت در همان صفحهٔ مرجع آمده است. امکاناتی مانند WebSocket عمومی پاسخ، fine-tuning و تخفیف batch ارائهدهنده در این نسخه ادعا نمیشوند.
دنبال کردن تغییر
هنگام اضافه شدن مسیر یا پارامتر جدید، مرجع OpenAPI و راهنمای مرتبط هم تغییر میکند. سرویسهای ارائهدهنده میتوانند مدل یا قیمت خود را تغییر دهند؛ صفحهٔ مدل زمان بررسی اطلاعات ارائهدهنده را نشان میدهد.
قرارداد API 1.6.0 · تاریخچهٔ تغییرات