رفتن به محتوای اصلی
SAROVI FOR DEVELOPERS

ساروی،
در محصول خودت.

از مدل‌های هوش مصنوعی، استودیو و عامل‌ها در برنامهٔ خودت استفاده کن. یک API، مستندات فارسی و همان اعتبار حساب ساروی.

Python · JavaScript · cURL
JavaScript · روی سرور
const response = await fetch(
  "https://api.sarovi.ir/v1/responses",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SAROVI_API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "z-ai/glm-5.3-flash",
      input: "سلام!",
      max_output_tokens: 512
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error.message);
console.log(result.output_text);
امکانات قابل استفاده از API

از یک پاسخ، تا یک جریان کامل.

مدل مناسب برای هر کار

مدل‌های ارائه‌دهندگان مختلف را با قابلیت و قیمت فیلتر کن. صفحهٔ هر مدل، ورودی‌ها و امکانات قابل استفاده در ساروی را توضیح می‌دهد.

راهنمای این قابلیت

پاسخ و استدلال اختیاری

پاسخ متنی را یک‌جا یا به‌صورت زنده دریافت کن. در مدل‌های پشتیبانی‌شده، متن استدلال یا خلاصهٔ ارائه‌دهنده را جدا از پاسخ نهایی نمایش بده.

راهنمای این قابلیت

ساخت با استودیو

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

راهنمای این قابلیت

عامل برای محصولت

مدل و دستورالعمل یک عامل را تعریف کن، اجرا را شروع کن و نتیجه را در محصولت استفاده کن. مسیرهای عامل گفتگویی و Work جداگانه مستند شده‌اند.

راهنمای این قابلیت

کلید با دسترسی مشخص

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

راهنمای این قابلیت

مصرف قابل پیگیری

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

راهنمای این قابلیت

یک حساب. همان اعتبار.

موجودی ساروی در API هم قابل استفاده است. قیمت هر مدل را پیش از انتخاب ببین و برای پروژه و کلید، سقف مصرف تعیین کن. رزرو موقت اعتبار بعد از پایان درخواست با مصرف واقعی تسویه می‌شود.

مدل‌ها و قیمت‌ها
شروع ساده

از اینجا شروع کن.

  1. ۰۱

    پروژه و کلید بساز

    با حساب ساروی وارد شو؛ کلید را با دسترسی‌های لازم بساز.

  2. ۰۲

    اولین درخواست را بفرست

    یک مدل انتخاب کن و نمونهٔ Python، JavaScript یا cURL را روی سرورت اجرا کن.

  3. ۰۳

    مصرف را ببین

    نتیجه را در آزمایشگاه بررسی کن و هزینه و وضعیت را در گزارش‌ها ببین.

قبل از شروع.

باید حساب یا کیف پول جدید بسازم؟

نه. با حساب ساروی وارد کنسول شو. API از همان موجودی اعتبار استفاده می‌کند؛ سقف پروژه و کلید را می‌توانی جدا تنظیم کنی.

از چه زبانی می‌توانم استفاده کنم؟

هر زبانی که درخواست HTTPS بفرستد. راهنماها و مرجع API نمونه‌های Python، JavaScript و cURL دارند. کلید محرمانه را فقط روی سرور نگه دار.

همهٔ مدل‌ها امکانات یکسان دارند؟

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

استدلال مدل همیشه برمی‌گردد؟

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

ایده‌ات را به API وصل کن.