رفتن به محتوا
سارویتوسعه‌دهندگان
مستندات/مرجع و تغییرات

تغییرات 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 · تاریخچهٔ تغییرات