# Sarovi API

Base URL: https://api.sarovi.ir/v1
Authentication: Authorization: Bearer $SAROVI_API_KEY
Shared Sarovi account credits. Never expose keys in browser code.

## Documentation
- [نمای کلی](https://api.sarovi.ir/developers/docs/overview): راهنما و نمونه‌کد API ساروی.
- [اولین درخواست شما](https://api.sarovi.ir/developers/docs/quickstart): با Python، TypeScript یا cURL یک پاسخ بگیرید و مصرف آن را در کنسول پیدا کنید.
- [ورود و کلیدهای API](https://api.sarovi.ir/developers/docs/authentication): احراز هویت، دسترسی‌های محدود، انقضا و تعویض کلید.
- [پروژه‌ها و محیط‌ها](https://api.sarovi.ir/developers/docs/projects): محیط آزمایش و محصول را جدا کنید و کنترل مصرف هر کدام را داشته باشید.
- [SDK و ابزارهای توسعه](https://api.sarovi.ir/developers/docs/sdks): کلاینت آشنای خود را نگه دارید یا از SDK ساروی برای قابلیت‌های اختصاصی استفاده کنید.
- [سازگاری با OpenAI و Anthropic](https://api.sarovi.ir/developers/docs/compatibility): قالب درخواست، قابلیت‌های پشتیبانی‌شده و تفاوت‌هایی که باید پیش از مهاجرت بدانید.
- [پاسخ و گفتگو](https://api.sarovi.ir/developers/docs/responses): پیام متنی، تاریخچهٔ گفتگو، دستورالعمل و خروجی قابل جریان.
- [پاسخ زنده با SSE](https://api.sarovi.ir/developers/docs/streaming): متن را هنگام تولید نمایش دهید و پایان واقعی جریان را تشخیص دهید.
- [ابزارها و خروجی ساختاریافته](https://api.sarovi.ir/developers/docs/tool-calling): فراخوانی تابع، JSON Schema و اتصال Sarovi CLI.
- [استدلال و خلاصهٔ مدل](https://api.sarovi.ir/developers/docs/reasoning): استدلال قابل نمایش را جدا از پاسخ نهایی، به‌صورت اختیاری دریافت کنید.
- [درک صدا و ویدیو](https://api.sarovi.ir/developers/docs/media-inputs): ارسال صدای WAV/MP3 و ویدیوی MP4 برای تحلیل مدل.
- [تولید و ویرایش تصویر](https://api.sarovi.ir/developers/docs/images): ساخت تصویر، تنظیم اندازه و فرمت، و استفاده از تصویر مرجع.
- [تولید و دریافت ویدیو](https://api.sarovi.ir/developers/docs/video): ثبت کار ویدیویی، بررسی وضعیت همان کار و دریافت نتیجه.
- [صدا، موسیقی و گفتار](https://api.sarovi.ir/developers/docs/audio): گوینده‌ها، لحن، گفت‌وگو با حداکثر ۸ گوینده، Whisper و GPT Audio.
- [گفتگوی صوتی مرورگر](https://api.sarovi.ir/developers/docs/business-voice): نمونهٔ WebRTC و مرز امکانات فعلی.
- [ساخت و اجرای عامل](https://api.sarovi.ir/developers/docs/agents): تعریف قابل استفادهٔ مجدد برای گفتگو، پژوهش، سند، کد یا داده.
- [کار ماندگار و فایل‌ها](https://api.sarovi.ir/developers/docs/work): پژوهش، ساخت سند، کدنویسی و تحلیل داده را به کار قابل پیگیری تبدیل کنید.
- [عامل پشتیبانی و فروش](https://api.sarovi.ir/developers/docs/business-agents): دانش، گفتگوهای مشتری، پیش‌نویس و نسخهٔ منتشرشده.
- [دانش متصل به عامل](https://api.sarovi.ir/developers/docs/business-knowledge): متن، سند و صفحهٔ وب با جداسازی پروژه‌ها.
- [برنامه‌های آمادهٔ اجرا](https://api.sarovi.ir/developers/docs/business-start): شروع با پشتیبانی، فروش، پردازش گروهی و صدای مرورگر.
- [پردازش گروهی متن](https://api.sarovi.ir/developers/docs/business-batches): برآورد، سقف اعتبار، لغو، تکرار ناموفق‌ها و خروجی ردیفی.
- [وب‌هوک و اتصال به CRM](https://api.sarovi.ir/developers/docs/business-webhooks): تحویل امضاشده، تلاش دوباره و ثبت رویداد یکتا.
- [نمونهٔ Python](https://api.sarovi.ir/developers/docs/python): یک نمونهٔ کامل با کتابخانهٔ استاندارد Python.
- [نمونهٔ JavaScript](https://api.sarovi.ir/developers/docs/javascript): اتصال از Node.js با fetch، مدیریت خطا و شناسهٔ درخواست.
- [آماده‌سازی محصول](https://api.sarovi.ir/developers/docs/production): الگوهای عملی برای اتصال پایدار و قابل پیگیری.
- [اعتبار، مصرف و پرداخت](https://api.sarovi.ir/developers/docs/billing): همان کیف پول ساروی؛ با تفکیک رزرو موقت، تسویه و سقف مصرف.
- [سقف‌ها و ظرفیت](https://api.sarovi.ir/developers/docs/limits): محدودیت درخواست، هم‌زمانی، اندازه و خروجی.
- [تلاش مجدد و Idempotency](https://api.sarovi.ir/developers/docs/retries): از اجرای تکراری درخواست پولی در قطع اتصال و خطا جلوگیری کنید.
- [خطاها و عیب‌یابی](https://api.sarovi.ir/developers/docs/errors): شکل خطا، کدهای اصلی و قدم بعدی مناسب.
- [گزارش و خروجی مصرف](https://api.sarovi.ir/developers/docs/logs): هر درخواست را از شناسه تا زمان، توکن و هزینه دنبال کنید.
- [هزینهٔ مشتری و خروجی مصرف](https://api.sarovi.ir/developers/docs/business-usage): شناسهٔ مشتری، گزارش صفحه‌بندی‌شده و آستانهٔ بودجه.
- [داده و حریم خصوصی](https://api.sarovi.ir/developers/docs/privacy): کنترل ثبت محتوا، نگه‌داری پاسخ و مرز منابع پروژه.
- [ساروی در ترمینال](https://api.sarovi.ir/developers/docs/cli): از نصب تا اولین کار؛ نقطهٔ شروع راهنمای Sarovi CLI.
- [برنامهٔ دسکتاپ ساروی](https://api.sarovi.ir/developers/docs/desktop): گفتگو، کار محلی، استودیو، صدا و انتشار سایت از macOS و Windows.
- [نصب با یک دستور و npm](https://api.sarovi.ir/developers/docs/cli-install): نصب مستقیم در Terminal و PowerShell، روش npm، بررسی فایل‌ها و به‌روزرسانی.
- [نصب در macOS](https://api.sarovi.ir/developers/docs/cli-macos): نصب روی Apple Silicon، ورود، مجوزها و اجرای دوباره.
- [نصب در Windows](https://api.sarovi.ir/developers/docs/cli-windows): نصب با یک راه‌انداز، میان‌بر Start و نکته‌های ترمینال و مجوزها.
- [ورود و رایانه‌های متصل](https://api.sarovi.ir/developers/docs/cli-account): ورود مرورگری، نام رایانه، انقضا و قطع دسترسی هر اتصال.
- [مدل‌ها و مصرف اعتبار](https://api.sarovi.ir/developers/docs/cli-models): انتخاب مدل دارای ابزار، قیمت، موجودی و محدودیت‌های مصرف.
- [ابزارها و مجوزها](https://api.sarovi.ir/developers/docs/cli-tools): آماده‌بودن ابزارها، تأیید عمل، مرورگر و کنترل برنامه‌ها.
- [فرمان‌ها و گفتگوها](https://api.sarovi.ir/developers/docs/cli-commands): مرجع فرمان‌های داخل گفتگو و ترمینال، ادامهٔ جلسه و حالت تک‌درخواست.
- [فارسی، ظاهر و دسترس‌پذیری](https://api.sarovi.ir/developers/docs/cli-language): تغییر زبان، نمایش فارسی، کنتراست و کاهش حرکت.
- [نمونهٔ کارهای واقعی](https://api.sarovi.ir/developers/docs/cli-examples): درخواست‌های قابل اجرا با نتیجهٔ روشن و قابل بررسی.
- [افزودن ابزار با MCP](https://api.sarovi.ir/developers/docs/cli-mcp): اتصال سرویس ابزار بیرونی و مدیریت آن از ساروی.
- [داده‌ها و کنترل دسترسی](https://api.sarovi.ir/developers/docs/cli-privacy): محل داده‌ها، اعتبارنامه‌ها و تفاوت خروج محلی با قطع اتصال.
- [رفع مشکل و بازیابی](https://api.sarovi.ir/developers/docs/cli-troubleshooting): از ورود و نمایش فارسی تا خطای مدل، سقف مصرف و ابزارها.
- [شروع با ابر ساروی](https://api.sarovi.ir/developers/docs/cloud): از Starter رایگان تا محصول دارای داده، ورود و میزبانی.
- [پایگاه‌داده و مجموعه‌ها](https://api.sarovi.ir/developers/docs/cloud-database): دادهٔ مالک‌محور با نمونه‌های JavaScript و Python.
- [ورود کاربران برنامه](https://api.sarovi.ir/developers/docs/cloud-auth): ثبت‌نام، ورود و نشست مخصوص برنامهٔ شما.
- [فایل و ذخیره‌سازی](https://api.sarovi.ir/developers/docs/cloud-storage): آپلود و دریافت خصوصی با نشست کاربر.
- [تابع‌های سرور](https://api.sarovi.ir/developers/docs/cloud-functions): JavaScript همگام در محیط مستقل و محدود.
- [انتشار وب‌سایت](https://api.sarovi.ir/developers/docs/cloud-hosting): انتشار فایل‌های ساخته‌شده روی HTTPS مستقل.
- [مرجع API](https://api.sarovi.ir/developers/docs/reference): مسیرها، پارامترها، نمونهٔ درخواست و پاسخ.
- [تغییرات API](https://api.sarovi.ir/developers/docs/changelog): تاریخچهٔ قرارداد عمومی ساروی.
- [OpenAPI](https://api.sarovi.ir/openapi.json): Machine-readable request contracts.

## Models
- [google/gemini-4-argon](https://api.sarovi.ir/developers/models/google~gemini-4-argon): استدلال، کدنویسی و تحلیل چندرسانه‌ای با زمینهٔ بلند
- [meta/muse-wonder](https://api.sarovi.ir/developers/models/meta~muse-wonder): استدلال عمیق و کارهای چندمرحله‌ای با زمینهٔ بلند
- [qwen/qwen3.8-flash](https://api.sarovi.ir/developers/models/qwen~qwen3.8-flash): گفت‌وگوی سریع با سهمیهٔ رایگان روزانه
- [anthropic/claude-haiku-5.5](https://api.sarovi.ir/developers/models/anthropic~claude-haiku-5.5): سریع برای نوشتن و تحلیل سبک
- [deepseek/deepseek-v4-flash-0731](https://api.sarovi.ir/developers/models/deepseek~deepseek-v4-flash-0731): سریع برای تحلیل و کدنویسی سبک
- [openai/gpt-5.6-luna](https://api.sarovi.ir/developers/models/openai~gpt-5.6-luna): مدل سریع OpenAI
- [openai/gpt-6-luna](https://api.sarovi.ir/developers/models/openai~gpt-6-luna): سریع و کم‌هزینه برای گفتگو و کارهای روزمره
- [google/gemini-3.7-flash](https://api.sarovi.ir/developers/models/google~gemini-3.7-flash): سریع با درک چندرسانه‌ای
- [z-ai/glm-5.3-flash](https://api.sarovi.ir/developers/models/z-ai~glm-5.3-flash): سریع و متعادل برای کار حرفه‌ای
- [deepseek/deepseek-v4-pro-0813](https://api.sarovi.ir/developers/models/deepseek~deepseek-v4-pro-0813): تحلیل و کدنویسی حرفه‌ای
- [qwen/qwen3.8-max](https://api.sarovi.ir/developers/models/qwen~qwen3.8-max): زمینهٔ بلند و چندزبانه
- [mistralai/mistral-medium-3-5](https://api.sarovi.ir/developers/models/mistralai~mistral-medium-3-5): مدل متعادل Mistral
- [mistralai/mistral-large-4-0](https://api.sarovi.ir/developers/models/mistralai~mistral-large-4-0): تحلیل، کدنویسی و متن بلند
- [x-ai/grok-4.6](https://api.sarovi.ir/developers/models/x-ai~grok-4.6): استدلال و اطلاعات روز
- [openai/gpt-5.6-terra](https://api.sarovi.ir/developers/models/openai~gpt-5.6-terra): مدل حرفه‌ای متعادل OpenAI
- [anthropic/claude-sonnet-5](https://api.sarovi.ir/developers/models/anthropic~claude-sonnet-5): نوشتن، تحلیل و کدنویسی دقیق
- [z-ai/glm-5.3](https://api.sarovi.ir/developers/models/z-ai~glm-5.3): استدلال عمیق با هزینهٔ کنترل‌شده
- [openai/gpt-5.6-sol](https://api.sarovi.ir/developers/models/openai~gpt-5.6-sol): استدلال عمیق و کار عامل‌محور
- [openai/gpt-6-sol](https://api.sarovi.ir/developers/models/openai~gpt-6-sol): تحلیل حرفه‌ای، کدنویسی و کار عامل‌محور
- [anthropic/claude-opus-5](https://api.sarovi.ir/developers/models/anthropic~claude-opus-5): مدل عمیق برای کارهای دشوار
- [anthropic/claude-opus-5.5](https://api.sarovi.ir/developers/models/anthropic~claude-opus-5.5): استدلال پیشرفته، کدنویسی و تحلیل پیچیده
- [moonshotai/kimi-k3](https://api.sarovi.ir/developers/models/moonshotai~kimi-k3): زمینهٔ بلند و پژوهش عمیق
- [qwen/qwen3.8-2.4t-a95b](https://api.sarovi.ir/developers/models/qwen~qwen3.8-2.4t-a95b): مدل بزرگ برای تحلیل پیچیده
- [anthropic/claude-fable-5](https://api.sarovi.ir/developers/models/anthropic~claude-fable-5): استدلال و تولید محتوای سطح بالا
- [anthropic/claude-fable-5.1](https://api.sarovi.ir/developers/models/anthropic~claude-fable-5.1): برای استدلال دشوار و کارهای عامل‌محور طولانی
- [openai/gpt-5.5-pro](https://api.sarovi.ir/developers/models/openai~gpt-5.5-pro): مدل عمیق OpenAI
- [openai/gpt-6-astra](https://api.sarovi.ir/developers/models/openai~gpt-6-astra): تحلیل پیچیده و کار عامل‌محور · هزینهٔ بالا
- [openai/gpt-6-astra-pro](https://api.sarovi.ir/developers/models/openai~gpt-6-astra-pro): مسائل دشوار و استدلال طولانی · هزینهٔ بالا
- [google/gemini-2.5-flash-image](https://api.sarovi.ir/developers/models/google~gemini-2.5-flash-image): طراحی عمومی و کار با تصویر مرجع
- [google/gemini-nano-banana-2.1](https://api.sarovi.ir/developers/models/google~gemini-nano-banana-2.1): نوشتن، بازنویسی و ایده‌پردازی
- [tencent/hy-image-v3.5-preview](https://api.sarovi.ir/developers/models/tencent~hy-image-v3.5-preview): طراحی عمومی و کار با تصویر مرجع
- [google/imagen-4.0-fast-generate-001](https://api.sarovi.ir/developers/models/google~imagen-4.0-fast-generate-001): پیش‌نویس، ایده‌پردازی و ساخت سریع
- [google/imagen-4.0-generate-001](https://api.sarovi.ir/developers/models/google~imagen-4.0-generate-001): عکاسی محصول و تصویر واقع‌گرایانه
- [meta/muse-image](https://api.sarovi.ir/developers/models/meta~muse-image): طراحی عمومی و کار با تصویر مرجع
- [bytedance-seed/seedream-5-0-lite](https://api.sarovi.ir/developers/models/bytedance-seed~seedream-5-0-lite): پیش‌نویس، ایده‌پردازی و ساخت سریع
- [bytedance-seed/seedream-5-0-pro](https://api.sarovi.ir/developers/models/bytedance-seed~seedream-5-0-pro): جزئیات بیشتر و خروجی نهایی پروژه
- [qwen/qwen-image-3](https://api.sarovi.ir/developers/models/qwen~qwen-image-3): طراحی عمومی و کار با تصویر مرجع
- [krea/krea-2-medium-turbo](https://api.sarovi.ir/developers/models/krea~krea-2-medium-turbo): پیش‌نویس، ایده‌پردازی و ساخت سریع
- [google/gemini-3.1-flash-lite-image](https://api.sarovi.ir/developers/models/google~gemini-3.1-flash-lite-image): پیش‌نویس، ایده‌پردازی و ساخت سریع
- [google/gemini-3.1-flash-image](https://api.sarovi.ir/developers/models/google~gemini-3.1-flash-image): طراحی عمومی و کار با تصویر مرجع
- [google/gemini-3-pro-image](https://api.sarovi.ir/developers/models/google~gemini-3-pro-image): جزئیات بیشتر و خروجی نهایی پروژه
- [openai/gpt-image-2](https://api.sarovi.ir/developers/models/openai~gpt-image-2): متن داخل تصویر، طراحی و ویرایش دقیق
- [openai/gpt-image-2.5-sunburst](https://api.sarovi.ir/developers/models/openai~gpt-image-2.5-sunburst): متن داخل تصویر، طراحی و ویرایش دقیق
- [openai/gpt-5.4-image-2](https://api.sarovi.ir/developers/models/openai~gpt-5.4-image-2): متن داخل تصویر، طراحی و ویرایش دقیق
- [google/veo-3.1-lite](https://api.sarovi.ir/developers/models/google~veo-3.1-lite): آزمون حرکت و کلیپ سریع
- [google/veo-3.1-fast](https://api.sarovi.ir/developers/models/google~veo-3.1-fast): آزمون حرکت و کلیپ سریع
- [kwaivgi/kling-v3.0-std](https://api.sarovi.ir/developers/models/kwaivgi~kling-v3.0-std): کلیپ نهایی و کنترل حرکت
- [bytedance/seedance-2.0-mini](https://api.sarovi.ir/developers/models/bytedance~seedance-2.0-mini): آزمون حرکت و کلیپ سریع
- [bytedance/seedance-2.0-fast](https://api.sarovi.ir/developers/models/bytedance~seedance-2.0-fast): آزمون حرکت و کلیپ سریع
- [bytedance/seedance-2.0](https://api.sarovi.ir/developers/models/bytedance~seedance-2.0): کلیپ نهایی و کنترل حرکت
- [bytedance/seedance-2.5](https://api.sarovi.ir/developers/models/bytedance~seedance-2.5): کلیپ نهایی و کنترل حرکت
- [alibaba/wan-3.0](https://api.sarovi.ir/developers/models/alibaba~wan-3.0): کلیپ نهایی و کنترل حرکت
- [runway/gen-4.5](https://api.sarovi.ir/developers/models/runway~gen-4.5): کلیپ نهایی و کنترل حرکت
- [x-ai/grok-imagine-video-1.5](https://api.sarovi.ir/developers/models/x-ai~grok-imagine-video-1.5): کلیپ نهایی و کنترل حرکت
- [x-ai/grok-imagine-video-1.5-lite](https://api.sarovi.ir/developers/models/x-ai~grok-imagine-video-1.5-lite): آزمون حرکت و کلیپ سریع
- [openai/sora-2-pro](https://api.sarovi.ir/developers/models/openai~sora-2-pro): کلیپ نهایی و کنترل حرکت
- [google/veo-3.1](https://api.sarovi.ir/developers/models/google~veo-3.1): کلیپ نهایی و کنترل حرکت
- [elevenlabs/eleven-v4](https://api.sarovi.ir/developers/models/elevenlabs~eleven-v4): گویندگی چندزبانه · انتخاب لحن و صدا
- [elevenlabs/eleven-v4-turbo](https://api.sarovi.ir/developers/models/elevenlabs~eleven-v4-turbo): گویندگی چندزبانه · انتخاب لحن و صدا
- [google/lyria-3-clip-preview](https://api.sarovi.ir/developers/models/google~lyria-3-clip-preview): موسیقی ۳۰ ثانیه‌ای · اقتصادی · ساز یا آواز
- [google/lyria-3-pro-preview](https://api.sarovi.ir/developers/models/google~lyria-3-pro-preview): آهنگ بلند با بخش‌بندی · ساز و آواز
- [mistralai/voxtral-mini-tts-2603](https://api.sarovi.ir/developers/models/mistralai~voxtral-mini-tts-2603): صداهای انگلیسی و فرانسوی · انتخاب لحن
- [google/gemini-3.1-flash-tts-preview](https://api.sarovi.ir/developers/models/google~gemini-3.1-flash-tts-preview): فارسی و چندزبانه · انتخاب مناسب نریشن
- [google/gemini-3.8-flash-tts](https://api.sarovi.ir/developers/models/google~gemini-3.8-flash-tts): فارسی و چندزبانه · انتخاب مناسب نریشن
- [google/gemini-3.8-flash-lite-tts](https://api.sarovi.ir/developers/models/google~gemini-3.8-flash-lite-tts): فارسی و چندزبانه · انتخاب مناسب نریشن
- [openai/gpt-audio-mini](https://api.sarovi.ir/developers/models/openai~gpt-audio-mini): پاسخ صوتی · متن یا فایل صوتی · اقتصادی
- [openai/gpt-audio](https://api.sarovi.ir/developers/models/openai~gpt-audio): پاسخ صوتی · متن یا فایل صوتی
- [openai/whisper-large-v3](https://api.sarovi.ir/developers/models/openai~whisper-large-v3): صدا به متن · پیاده‌سازی چندزبانه
- [openai/whisper-large-v3-turbo](https://api.sarovi.ir/developers/models/openai~whisper-large-v3-turbo): صدا به متن · پیاده‌سازی سریع و اقتصادی
- [google/gemini-3.1-flash-lite](https://api.sarovi.ir/developers/models/google~gemini-3.1-flash-lite): پیش‌نویس، ایده‌پردازی و ساخت سریع
- [google/gemini-3.1-pro-preview](https://api.sarovi.ir/developers/models/google~gemini-3.1-pro-preview): نوشتن، بازنویسی و ایده‌پردازی
- [inclusionai/ling-3.1-flash](https://api.sarovi.ir/developers/models/inclusionai~ling-3.1-flash): نوشتن، بازنویسی و ایده‌پردازی

## Important behavior
Non-streaming requests return JSON. Responses support SSE with stream=true. Video and durable Work require polling. Idempotency-Key prevents repeat execution for the same API key; JSON replay below 1 MB is retained for 24 hours. Store files in your application. Financial limits use the existing shared credit ledger. /v1/chat/completions supports the documented OpenAI Chat Completions subset, function tools, image message parts and response_format. Agent Responses supports flat function tools and text.format. Consult OpenAPI for supported fields.