درواره چیست؟ معرفی کامل پلتفرم API هوش مصنوعی برای توسعهدهندگان و کسبوکارهای ایرانی
درواره پلتفرم یکپارچۀ API هوش مصنوعی است که با یک API Key، کیف پول ریالی و رابط سازگار با OpenAI، دسترسی توسعهدهندگان ایرانی به صدها مدل متن، تصویر، صوت و ویدئو را فراهم میکند.
هوش مصنوعی در حال تبدیل شدن به یکی از اجزای اصلی نرمافزارهای مدرن است. از چتباتها، دستیارهای هوشمند و سیستمهای RAG گرفته تا ابزارهای تولید تصویر، صوت، ویدئو و Agentهای خودکار، تقریباً تمام این محصولات برای انجام وظایف خود به مدلهای هوش مصنوعی متصل میشوند.
اما اتصال یک نرمافزار به اکوسیستم جهانی هوش مصنوعی فقط به نوشتن چند خط کد محدود نیست. توسعهدهندگان و کسبوکارهای ایرانی معمولاً با مجموعهای از مشکلات فنی و مالی روبهرو هستند:
- دسترسی دشوار به ارائهدهندگان بینالمللی
- نیاز به پرداخت ارزی
- ایجاد و نگهداری چندین حساب مختلف
- مدیریت تعداد زیادی API Key
- تفاوت ساختار API ارائهدهندگان
- تغییر مداوم مدلها و قیمتها
- دشواری محاسبۀ هزینه مصرف
- محدودیتهای منطقهای
- Rate Limitهای متفاوت
- پیچیدگی مهاجرت از یک مدل به مدل دیگر
- نبود یک داشبورد فارسی برای مدیریت مصرف
- دشواری صدور رسید و گزارش مالی
- پراکندگی مستندات فنی
درواره برای حل همین مسائل ساخته شده است.
درواره یک پلتفرم یکپارچۀ API هوش مصنوعی و AI API Gateway برای توسعهدهندگان، استارتاپها، تیمهای محصول و کسبوکارهای ایرانی است. با درواره میتوانید از طریق یک حساب، یک کیف پول ریالی، یک API Key و یک Base URL به صدها مدل هوش مصنوعی دسترسی داشته باشید.
بهجای ایجاد اتصال جداگانه به هر شرکت و مدیریت چندین قرارداد فنی و مالی، کافی است نرمافزار خود را یکبار به درواره متصل کنید و مدل موردنظر را در هر درخواست انتخاب کنید.
یک حساب
یک کیف پول ریالی
یک API Key
یک Base URL
صدها مدل هوش مصنوعی
پاسخ کوتاه: درواره چیست؟
درواره یک زیرساخت یکپارچۀ API هوش مصنوعی برای ایران است که دسترسی به صدها مدل متن، تصویر، صوت، ویدئو، کدنویسی، Embedding و مدلهای چندوجهی را از طریق یک رابط واحد فراهم میکند.
API درواره با ساختار OpenAI سازگار است. در بسیاری از ابزارها و برنامهها کافی است Base URL و API Key را تغییر دهید:
Base URL: https://api.darvareh.ir/v1
API Key: کلید ساختهشده در حساب درواره
Model ID: شناسه مدل انتخابشده
پس از اتصال، میتوانید مدل مناسب را انتخاب کنید، مصرف خود را در داشبورد ببینید، کیف پول را بهصورت ریالی شارژ کنید و درخواستها را از طریق آزمایشگاه مدلها یا کد برنامه آزمایش کنید.
چرا نام «درواره» انتخاب شده است؟
«درواره» برابر فارسی پیشنهادشده برای واژۀ انگلیسی Gateway است. Gateway در معماری نرمافزار، لایه یا نقطۀ ورودیای است که درخواستها از طریق آن به سرویسهای مختلف هدایت میشوند.
نام درواره نیز دقیقاً از همین مفهوم گرفته شده است.
درواره میان نرمافزار شما و اکوسیستم مدلهای هوش مصنوعی قرار میگیرد. برنامه درخواست را به یک نقطۀ ورود واحد ارسال میکند و درواره آن را به مدل و زیرساخت مناسب هدایت میکند.
نرمافزار شما
↓
درواره
↓
مدلهای هوش مصنوعی
این معماری باعث میشود برنامه برای استفاده از مدلهای مختلف به اتصال جداگانه نیاز نداشته باشد.
به همین دلیل، مأموریت درواره را میتوان در یک جمله خلاصه کرد:
یک اتصال برای دسترسی به تمام اکوسیستم هوش مصنوعی
درواره چه مشکلی را حل میکند؟
فرض کنید میخواهید یک محصول هوش مصنوعی بسازید که قابلیتهای زیر را داشته باشد:
- چت هوشمند
- تحلیل سند
- تولید کد
- ساخت تصویر
- تبدیل گفتار به متن
- تولید صدا
- ساخت ویدئو
- جستوجوی معنایی
- عامل هوش مصنوعی
در روش اتصال مستقیم، ممکن است مجبور شوید برای هر قابلیت از یک ارائهدهندۀ جداگانه استفاده کنید:
مدل زبانی → ارائهدهنده اول
تولید تصویر → ارائهدهنده دوم
تولید ویدئو → ارائهدهنده سوم
مدل صوتی → ارائهدهنده چهارم
Embedding → ارائهدهنده پنجم
در این وضعیت باید موارد زیر را جداگانه مدیریت کنید:
- ثبتنام
- احراز هویت
- پرداخت
- API Key
- مستندات
- SDK
- خطاها
- Rate Limit
- قیمت
- صورتحساب
- مانیتورینگ
- تغییرات API
با درواره، این ارتباط سادهتر میشود:
اپلیکیشن شما
↓
API واحد درواره
↓
مدل انتخابشده
برنامه فقط با API درواره ارتباط برقرار میکند و مدل موردنظر از طریق فیلد model مشخص میشود.
درواره برای چه کسانی ساخته شده است؟
توسعهدهندگان نرمافزار
اگر میخواهید قابلیت هوش مصنوعی را به Backend، وبسایت، اپلیکیشن یا سرویس خود اضافه کنید، میتوانید از API سازگار با OpenAI درواره استفاده کنید.
استارتاپها
استارتاپها میتوانند بدون ایجاد چندین اتصال و حساب خارجی، مدلهای مختلف را آزمایش کنند و مناسبترین گزینه را برای محصول خود انتخاب کنند.
تیمهای محصول
تیم محصول میتواند مدلها را از نظر کیفیت، سرعت و هزینه مقایسه کند و برای هر قابلیت از مدل مناسب استفاده کند.
کسبوکارهای کوچک و متوسط
کسبوکارهایی که به پرداخت ارزی یا زیرساخت پیچیده دسترسی ندارند، میتوانند کیف پول خود را بهصورت ریالی شارژ و مصرف را از داشبورد فارسی مدیریت کنند.
تیمهای هوش مصنوعی و داده
تیمهای هوش مصنوعی میتوانند مدلهای زبانی، Embedding، Reranking و مدلهای چندوجهی را در معماری RAG، Agent و پردازش داده استفاده کنند.
شرکتهای نرمافزاری
شرکتهای نرمافزاری میتوانند قابلیتهای هوش مصنوعی را به محصولات موجود خود اضافه کنند، بدون آنکه تمام پیچیدگی اتصال به ارائهدهندگان مختلف را به مشتری نهایی منتقل کنند.
توسعهدهندگان مستقل
برنامهنویسان مستقل میتوانند بدون راهاندازی زیرساخت سنگین، مدلهای مختلف را از طریق Playground یا API آزمایش کنند.
شرکا و ارائهدهندگان خدمات
درواره دارای زیرساخت همکاری و پرتال شریک است تا شرکای تجاری بتوانند مشتریان خود را مدیریت و اعتبار موردنیاز آنها را تخصیص دهند.
مهمترین مزایای درواره
دسترسی به صدها مدل با یک API
درواره دسترسی به صدها مدل هوش مصنوعی را از طریق یک نقطۀ اتصال فراهم میکند.
این مدلها فقط به چت متنی محدود نیستند و دستههای مختلفی را پوشش میدهند:
- مدلهای زبانی
- مدلهای استدلالی
- مدلهای کدنویسی
- مدلهای چندوجهی
- مدلهای تولید تصویر
- مدلهای تحلیل تصویر
- مدلهای تولید ویدئو
- مدلهای صوتی
- تبدیل گفتار به متن
- تبدیل متن به گفتار
- مدلهای تولید موسیقی
- Embedding
- Reranking
- مدلهای مناسب RAG
- مدلهای مناسب Agent
- مدلهای سریع و اقتصادی
- مدلهای قدرتمند برای تحلیل پیچیده
فهرست مدلها، شناسه قابلاستفاده، قیمت و قابلیتهای هر مدل در کاتالوگ مدلهای درواره قابلمشاهده است.
یک API Key بهجای چندین کلید
در اتصال مستقیم به چند ارائهدهنده، باید کلیدهای مختلفی نگهداری کنید:
Provider A API Key
Provider B API Key
Provider C API Key
Provider D API Key
در درواره، برنامه از یک API Key استفاده میکند:
DARVAREH_API_KEY
این رویکرد مدیریت Secretها را سادهتر و ریسک پراکندگی کلیدهای حساس را کمتر میکند.
API Key درواره باید فقط در Backend، Secret Manager یا متغیرهای محیطی نگهداری شود و نباید در کد Frontend قرار گیرد.
کیف پول و پرداخت ریالی
یکی از موانع اصلی استفاده از سرویسهای جهانی هوش مصنوعی برای کاربران ایرانی، پرداخت ارزی است.
در درواره میتوانید کیف پول خود را بهصورت ریالی و از طریق درگاه پرداخت شارژ کنید. پس از تکمیل پرداخت، اعتبار به کیف پول حساب اضافه میشود و مصرف API از همان اعتبار محاسبه خواهد شد.
بستههای شارژ در پنل شامل مقادیر زیر هستند:
- ۱۰۰ هزار تومان
- ۵۰۰ هزار تومان
- ۵ میلیون تومان
- ۱۰ میلیون تومان و بیشتر
وجود کیف پول ریالی باعث میشود برای استفاده از مدلهای مختلف به پرداخت جداگانه به هر ارائهدهنده نیاز نداشته باشید.
داشبورد فارسی
درواره یک داشبورد فارسی و راستبهچپ برای مدیریت حساب، مصرف و دسترسیهای توسعهدهندگان ارائه میکند.
در این داشبورد میتوانید بخشهای مختلف حساب را مدیریت کنید:
- کیف پول
- API Keyها
- مدلها
- مصرف API
- هزینهها
- آزمایشگاه مدلها
- مستندات
- خطاها
- صورتحساب
- پروفایل
- تیکتهای پشتیبانی
هدف داشبورد این است که مدیریت زیرساخت هوش مصنوعی برای کاربران ایرانی شفاف و قابلفهم باشد.
API سازگار با OpenAI
API درواره با ساختار رایج OpenAI API سازگار است. این سازگاری باعث میشود بتوانید از SDKها و ابزارهایی استفاده کنید که امکان تنظیم Base URL سفارشی دارند.
Base URL درواره:
https://api.darvareh.ir/v1
Endpoint رایج Chat Completions:
POST https://api.darvareh.ir/v1/chat/completions
فهرست مدلها:
GET https://api.darvareh.ir/v1/models
احراز هویت با Bearer Token انجام میشود:
Authorization: Bearer YOUR_DARVAREH_API_KEY
در بسیاری از پروژههای موجود، مهاجرت به درواره با تغییر این سه مقدار انجام میشود:
API Key
Base URL
Model ID
امکان استفاده از SDKهای آشنا
بهدلیل سازگاری API، میتوانید در قابلیتهای سازگار از SDK رسمی OpenAI یا درخواست مستقیم HTTP استفاده کنید.
زبانها و روشهای رایج:
- cURL
- Python
- JavaScript
- TypeScript
- Node.js
- PHP
- Laravel
- Next.js
- REST Client
- Postman
همچنین ابزارهایی که ارائهدهندۀ سفارشی یا OpenAI-Compatible API میپذیرند، معمولاً با Base URL و API Key درواره قابلتنظیماند.
آزمایشگاه برای آزمایش مدلها
پیش از اینکه API را در محصول خود پیادهسازی کنید، میتوانید از آزمایشگاه درواره برای آزمایش درخواستها استفاده کنید.
آزمایشگاه به شما کمک میکند:
- مدل موردنظر را انتخاب کنید.
- پرامپت را آزمایش کنید.
- پاسخ مدل را مشاهده کنید.
- پارامترهای درخواست را تغییر دهید.
- ساختار درخواست و پاسخ را بررسی کنید.
- مصرف و هزینه را بهتر درک کنید.
- پیش از نوشتن کد، سازگاری مدل را ارزیابی کنید.
این محیط برای مقایسۀ اولیه مدلها و بررسی رفتار پرامپت بسیار مفید است.
فهرست مدلها
درواره برای انتخاب سادهتر مدلها، کاتالوگ مدل ارائه میکند.
در کاتالوگ میتوانید اطلاعات مربوط به مدلها را مشاهده و مقایسه کنید:
- نام مدل
- Model ID
- نوع مدل
- دستهبندی
- قیمت
- قابلیتها
- نوع ورودی
- نوع خروجی
- ارائهدهنده
- وضعیت دسترسی
بهتر است Model ID را مستقیماً از کاتالوگ درواره دریافت کنید؛ زیرا نام تجاری مدل لزوماً با شناسه قابلاستفاده در API یکسان نیست.
گزارش مصرف و هزینه
پس از شروع استفاده از API، میتوانید مصرف خود را در بخش مصرف مشاهده کنید.
اطلاعات قابلبررسی میتوانند شامل موارد زیر باشند:
- تعداد درخواستها
- مدل استفادهشده
- توکن ورودی
- توکن خروجی
- مجموع مصرف
- هزینه درخواست
- زمان درخواست
- وضعیت پاسخ
- API Key مصرفکننده
- روند مصرف روزانه
این گزارشها برای چند هدف مهم کاربرد دارند:
- کنترل هزینه
- شناسایی مدلهای پرمصرف
- بررسی رفتار کاربران
- مقایسۀ مدلها
- تشخیص مصرف غیرعادی
- برنامهریزی بودجه
- عیبیابی درخواستها
مدیریت API Key
در بخش API Keyها میتوانید کلیدهای دسترسی خود را ایجاد و مدیریت کنید.
بهتر است برای هر پروژه یا محیط یک کلید مستقل بسازید:
development-key
staging-key
production-key
mobile-backend-key
support-agent-key
این جداسازی مزایای مهمی دارد:
- تشخیص مصرف هر پروژه
- لغو یک کلید بدون اختلال در دیگر پروژهها
- اعمال محدودیت جداگانه
- کنترل بهتر بودجه
- افزایش امنیت
- عیبیابی سادهتر
کلید ساختهشده را در یک محل امن ذخیره کنید؛ زیرا ممکن است مقدار کامل آن فقط هنگام ایجاد نمایش داده شود.
محدودیت مصرف و بودجه API Key
API Keyهای پیشرفته میتوانند برای کنترل مصرف دارای محدودیتهایی مانند موارد زیر باشند:
- محدودیت درخواست در دقیقه
- محدودیت بودجه
- محدودیت مدلهای مجاز
- محدودیت دسترسی
- وضعیت فعال یا غیرفعال
- محدودیتهای مرتبط با مصرف
این قابلیت به تیمها کمک میکند مصرف یک پروژه یا محیط آزمایشی را از مصرف اصلی جدا کنند.
Streaming
درواره از Streaming برای مسیرهای سازگار پشتیبانی میکند. در این حالت، پاسخ مدل بهتدریج به برنامه ارسال میشود.
Streaming برای کاربردهای زیر مناسب است:
- چتبات
- دستیار هوشمند
- تولید متن طولانی
- دستیار کدنویسی
- رابطهای تعاملی
برای فعالسازی معمولاً مقدار زیر در درخواست قرار میگیرد:
{
"stream": true
}
کاربر بهجای انتظار برای کامل شدن پاسخ، بخشهای تولیدشده را بهتدریج مشاهده میکند.
معماری چندارائهدهندهای
درواره به یک ارائهدهنده محدود نیست. معماری چندارائهدهندهای به پلتفرم اجازه میدهد مدلها و مسیرهای مختلف را در یک زیرساخت یکپارچه مدیریت کند.
مزایای این معماری:
- دسترسی به مدلهای متنوع
- کاهش وابستگی به یک ارائهدهنده
- امکان تغییر مسیر مدل
- مدیریت متمرکز مصرف
- امکان توسعه مدلهای قابلارائه
- انعطاف بیشتر در انتخاب مدل
مسیریابی و جایگزینی مدل
در زیرساخت چندارائهدهندهای، امکان تعریف مسیرهای جایگزین برای مدلها وجود دارد.
جایگزینی مدل به این معناست که اگر مسیر اصلی بهدلیل خطای موقت، Rate Limit یا اختلال ارائهدهنده در دسترس نباشد، درخواست بتواند براساس تنظیمات زیرساخت به مسیر دیگری منتقل شود.
این قابلیت میتواند پایداری محصول را افزایش دهد، اما مدلهای جایگزین باید از نظر قابلیت و کیفیت سازگار باشند.
جایگزینی مدل ممکن است برای موارد زیر مفید باشد:
- خطای موقت ارائهدهنده مدل
- Rate Limit
- Timeout
- عدم دسترسی مدل
- اختلال مسیر اصلی
پایش درخواستها
زیرساخت درواره امکان ثبت و پایش درخواستهای ارائهدهندگان را فراهم میکند.
این لایه برای بررسی موارد زیر کاربرد دارد:
- وضعیت درخواست
- زمان پاسخ
- مدل مقصد
- خطای ارائهدهنده مدل
- نرخ موفقیت
- وضعیت مسیر
- مصرف
- هزینه
- رفتار جایگزینی
مشاهدهپذیری برای یک AI Gateway ضروری است؛ زیرا موفق بودن پاسخ HTTP بهتنهایی برای ارزیابی کیفیت و عملکرد مدل کافی نیست.
مدیریت مالی و صورتحساب
درواره فقط یک مسیر فنی برای ارسال درخواست نیست؛ لایۀ مالی مصرف نیز در پنل مدیریت میشود.
امکانات مالی شامل این موارد است:
- کیف پول ریالی
- شارژ آنلاین
- بستههای اعتبار
- ثبت تراکنشها
- گزارش مصرف
- رسید پرداخت
- فاکتور و گزارش مالی
- نمایش مبلغ مصرفشده
- کنترل کمبود موجودی
وجود این لایه به کسبوکارها کمک میکند مصرف فنی و مالی API را در یک محیط واحد مشاهده کنند.
محافظت در برابر کمبود موجودی
اگر موجودی کیف پول برای ادامۀ مصرف کافی نباشد، سیستم بیلینگ باید پیش از ارسال درخواست جدید وضعیت موجودی را بررسی کند.
در زیرساخت درواره، محافظ کیف پول برای جلوگیری از ادامۀ مصرف بدون موجودی در نظر گرفته شده است. در صورت خالی شدن کیف پول، کلیدهای مرتبط میتوانند بهدلیل نبود اعتبار متوقف شوند.
پس از شارژ مجدد کیف پول، کلیدهایی که فقط بهعلت کمبود موجودی متوقف شدهاند میتوانند براساس سیاست حساب دوباره فعال شوند.
کلیدهایی که بهدلایل امنیتی، مدیریتی یا سوءاستفاده لغو شدهاند، نباید صرفاً با شارژ کیف پول فعال شوند.
پشتیبانی و تیکت
کاربران میتوانند برای پرسشهای فنی، مالی یا بررسی مشکلات حساب از بخش پشتیبانی تیکت ثبت کنند.
برای دریافت پاسخ دقیقتر بهتر است اطلاعات زیر را در تیکت قرار دهید:
- Request ID
- Model ID
- زمان تقریبی درخواست
- کد وضعیت HTTP
- متن خطا
- زبان یا SDK استفادهشده
- Streaming یا غیر Streaming بودن درخواست
- شرح رفتار موردانتظار
- شرح رفتار مشاهدهشده
API Key کامل، رمز عبور یا اطلاعات حساس را در متن تیکت قرار ندهید.
پرتال شریک
درواره دارای زیرساخت همکاری با شرکای تجاری است.
در پرتال شریک، امکاناتی مانند موارد زیر در نظر گرفته شده است:
- مدیریت مشتریان شریک
- دعوت مشتری
- تخصیص اعتبار
- مشاهده تخصیصهای انجامشده
- تعریف قواعد قیمتگذاری شریک
- ثبت رویدادها و گزارشهای مرتبط
- مدیریت ارتباط مالی با مشتریان شریک
این بخش برای شرکتهای نرمافزاری و بر اساس درخواست کاربر، ارائهدهندگان خدمات و مجموعههایی مناسب است که میخواهند دسترسی API هوش مصنوعی را در اختیار مشتریان خود قرار دهند.
چه مدلهایی در درواره قابلاستفادهاند؟
فهرست مدلها دائماً در حال توسعه است؛ بنابراین کاتالوگ مدلهای درواره مرجع اصلی مدلهای فعال، قیمت و قابلیتها است.
دستهبندی کلی مدلها شامل موارد زیر میشود.
مدلهای متنی
مناسب برای:
- چت
- پاسخگویی
- خلاصهسازی
- ترجمه
- بازنویسی
- استخراج اطلاعات
- دستهبندی
- تحلیل متن
- تولید محتوا
مدلهای استدلالی
مناسب برای:
- حل مسئلۀ چندمرحلهای
- تحلیل پیچیده
- برنامهریزی
- مسائل فنی
- ریاضیات
- استدلال منطقی
- تصمیمسازی با قیود متعدد
مدلهای کدنویسی
مناسب برای:
- تولید کد
- تکمیل کد
- رفع خطا
- ریفکتورینگ
- نوشتن تست
- بررسی ریپازیتوری
- توضیح کد
- ساخت عامل کدنویسی
مدلهای چندوجهی
مناسب برای پردازش ترکیبی متن و تصویر:
- تحلیل تصویر
- بررسی اسکرینشات
- OCR معنایی
- استخراج اطلاعات از سند
- تحلیل نمودار
- پاسخگویی درباره تصویر
مدلهای تولید تصویر
مناسب برای:
- تولید تصویر از متن
- ویرایش تصویر
- طراحی محصول
- تصویر تبلیغاتی
- تصویر وبلاگ
- Concept Art
- ساخت Variant
- استفاده از تصویر مرجع
مدلهای تولید ویدئو
مناسب برای:
- Text-to-Video
- Image-to-Video
- First Frame
- Last Frame
- Reference-to-Video
- ویدئوی تبلیغاتی
- محتوای شبکه اجتماعی
- شبیهسازی حرکت
مدلهای صوتی
مناسب برای:
- Speech-to-Text
- Text-to-Speech
- تبدیل صدا
- Transcript
- ترجمه صوت
- تولید موسیقی
- تولید افکت صوتی
مدلهای Embedding
مناسب برای:
- جستوجوی معنایی
- RAG
- تشخیص شباهت
- دستهبندی
- پیشنهاد محتوا
- Vector Database
مدلهای Reranking
مناسب برای بهبود ترتیب نتایج جستوجوی معنایی و انتخاب مرتبطترین اسناد.
چه محصولاتی میتوان با API درواره ساخت؟
چتبات هوشمند
میتوانید یک چتبات برای سایت، اپلیکیشن یا سیستم داخلی بسازید.
دستیار سازمانی
مدلی که به کارکنان برای پاسخگویی، نگارش، تحلیل و انجام وظایف روزمره کمک کند.
سیستم RAG
اسناد سازمان را به یک پایگاه دانش قابلجستوجو تبدیل کنید و پاسخها را براساس منابع داخلی تولید کنید.
عامل هوش مصنوعی
مدل را به ابزارها، APIها و دادههای برنامه متصل کنید تا وظایف چندمرحلهای انجام دهد.
دستیار کدنویسی
مدلهای کدنویسی را در IDE، ابزار داخلی یا فرایند Code Review استفاده کنید.
تحلیل اسناد
اطلاعات را از قرارداد، فاکتور، گزارش، فرم یا فایلهای متنی و تصویری استخراج کنید.
تولید محتوای متنی
توضیحات محصول، مقالۀ اولیه، پست شبکه اجتماعی، ایمیل و محتوای بازاریابی تولید کنید.
تولید تصویر
تصاویر محصول، تبلیغات، شبکه اجتماعی، کاور و محتوای بصری بسازید.
تولید ویدئو
از مدلهای Text-to-Video و Image-to-Video برای ساخت محتوای ویدئویی استفاده کنید.
پردازش صوت
فایل صوتی را به متن تبدیل یا از متن، صدای مصنوعی تولید کنید.
جستوجوی معنایی
جستوجویی بسازید که فقط به تطبیق کلمات محدود نباشد و مفهوم پرسش را درک کند.
دستهبندی و استخراج داده
تیکتها، پیامها، نظرات، اسناد و دادههای متنی را دستهبندی یا به JSON ساختاریافته تبدیل کنید.
آیا درواره فقط برای برنامهنویسان است؟
API اصلی درواره برای استفاده در نرمافزارها طراحی شده است، اما برای آزمایش اولیه الزاماً به نوشتن کد نیاز ندارید.
با استفاده از آزمایشگاه میتوانید:
- مدل را انتخاب کنید.
- پرامپت بنویسید.
- پاسخ را ببینید.
- کیفیت مدل را مقایسه کنید.
- رفتار مدل را قبل از پیادهسازی بررسی کنید.
برای اتصال نهایی به وبسایت یا محصول، آشنایی با API یا همکاری یک توسعهدهنده لازم خواهد بود.
راهنمای ثبتنام در درواره
برای شروع استفاده از درواره مراحل زیر را انجام دهید.
مرحلۀ اول: ورود به سایت درواره
وارد وبسایت درواره شوید:
گزینۀ ثبتنام یا ورود را انتخاب کنید.
مرحلۀ دوم: ساخت حساب
فرایند ثبتنام را تکمیل کنید. ورود با حساب Google نیز در پلتفرم در دسترس است.
پس از ورود اولیه، پروفایل و فضای حساب شما ایجاد میشود.
مرحلۀ سوم: تکمیل پروفایل
اطلاعات پروفایل را بررسی و تکمیل کنید. در بخش پروفایل امکان ثبت و تأیید شمارۀ موبایل نیز وجود دارد.
تأیید اطلاعات حساب میتواند برای امنیت بیشتر و دسترسی به بخشهای مالی یا پشتیبانی اهمیت داشته باشد.
مرحلۀ چهارم: ورود به داشبورد
پس از ثبتنام وارد داشبورد میشوید. داشبورد نقطۀ مرکزی مدیریت موارد زیر است:
- مدلها
- API Keyها
- آزمایشگاه مدلها
- مصرف
- کیف پول
- صورتحساب
- پشتیبانی
- تنظیمات حساب
راهنمای شارژ کیف پول
ورود به بخش کیف پول یا بیلینگ
از داشبورد وارد بخش کیف پول و پرداخت شوید.
انتخاب مبلغ شارژ
یکی از بستههای موجود را انتخاب کنید:
- ۱۰۰ هزار تومان
- ۵۰۰ هزار تومان
- ۵ میلیون تومان
- ۱۰ میلیون تومان
پرداخت آنلاین
پس از انتخاب بسته، به درگاه پرداخت هدایت میشوید.
بازگشت به درواره
پس از پرداخت موفق، به سایت درواره بازگردانده میشوید و وضعیت پرداخت بررسی میشود.
بررسی موجودی
موجودی جدید کیف پول را در داشبورد بررسی کنید. بهتر است رسید یا شناسه پرداخت را نیز برای پیگیری احتمالی نگهداری کنید.
راهنمای ساخت API Key
ورود به بخش توسعهدهندگان
از داشبورد وارد بخش API Keyها شوید.
انتخاب ساخت کلید جدید
گزینۀ ایجاد API Key را انتخاب کنید.
انتخاب نام مشخص
برای کلید یک نام قابلتشخیص تعیین کنید:
my-app-production
نامهای مناسب:
website-development
website-production
mobile-backend
internal-support-agent
rag-service
تعیین محدودیتها
اگر برای کلید گزینههای محدودسازی در دسترس هستند، آنها را متناسب با پروژه تنظیم کنید:
- بودجه
- RPM
- مدلهای مجاز
- وضعیت دسترسی
ذخیرۀ امن کلید
کلید را در Secret Manager یا متغیر محیطی ذخیره کنید:
DARVAREH_API_KEY=YOUR_DARVAREH_API_KEY
کلید را در این محلها قرار ندهید:
- Frontend
- Repository عمومی
- فایل HTML
- اپلیکیشن موبایل
- اسکرینشات
- تیکت پشتیبانی
- Query String
- ابزار Analytics
انتخاب مدل
پس از ساخت API Key وارد کاتالوگ مدلها شوید و مدل مناسب را انتخاب کنید.
هنگام انتخاب مدل این موارد را بررسی کنید:
- نوع وظیفه
- کیفیت
- قیمت
- سرعت
- زبان فارسی
- Context Window
- Streaming
- Tool Calling
- Structured Output
- ورودی تصویر
- نوع خروجی
- محدودیتهای مدل
Model ID را کپی و در درخواست قرار دهید:
{
"model": "MODEL_ID"
}
اولین درخواست با cURL
curl "https://api.darvareh.ir/v1/chat/completions" \
-H "Authorization: Bearer $DARVAREH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "system",
"content": "شما یک دستیار دقیق و حرفهای هستید."
},
{
"role": "user",
"content": "درواره را در سه بند معرفی کن."
}
]
}'
در این مثال:
DARVAREH_API_KEYکلید حساب شما است.MODEL_IDباید از کاتالوگ مدلها انتخاب شود.- درخواست به Endpoint سازگار با OpenAI ارسال میشود.
اولین درخواست با Python
نصب SDK:
pip install openai
کد:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DARVAREH_API_KEY"],
base_url="https://api.darvareh.ir/v1",
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[
{
"role": "system",
"content": "پاسخ را دقیق و به زبان فارسی بنویس."
},
{
"role": "user",
"content": "پنج کاربرد API هوش مصنوعی را معرفی کن."
}
],
)
print(response.choices[0].message.content)
اولین درخواست با Node.js
نصب SDK:
npm install openai
کد:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DARVAREH_API_KEY,
baseURL: "https://api.darvareh.ir/v1",
});
const response = await client.chat.completions.create({
model: "MODEL_ID",
messages: [
{
role: "system",
content: "پاسخ را دقیق و به زبان فارسی بنویس.",
},
{
role: "user",
content: "درواره چه مشکلی را حل میکند؟",
},
],
});
console.log(response.choices[0]?.message?.content);
اولین درخواست با PHP
<?php
$apiKey = getenv('DARVAREH_API_KEY');
$payload = [
'model' => 'MODEL_ID',
'messages' => [
[
'role' => 'system',
'content' => 'پاسخ را به زبان فارسی بنویس.',
],
[
'role' => 'user',
'content' => 'API هوش مصنوعی چیست؟',
],
],
];
$ch = curl_init(
'https://api.darvareh.ir/v1/chat/completions'
);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(
$payload,
JSON_UNESCAPED_UNICODE
),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
if ($status < 200 || $status >= 300) {
throw new RuntimeException(
"Darvareh API returned HTTP {$status}: {$response}"
);
}
$data = json_decode(
$response,
true,
512,
JSON_THROW_ON_ERROR
);
echo $data['choices'][0]['message']['content'] ?? '';
فعالسازی Streaming
نمونۀ Node.js:
const stream = await client.chat.completions.create({
model: "MODEL_ID",
stream: true,
messages: [
{
role: "user",
content: "یک راهنمای کوتاه درباره هوش مصنوعی بنویس.",
},
],
});
for await (const chunk of stream) {
const content = chunk.choices[0]?.delta?.content;
if (content) {
process.stdout.write(content);
}
}
اتصال یک پروژۀ موجود به درواره
اگر پروژه شما از SDK رسمی OpenAI استفاده میکند، Client احتمالاً ساختاری شبیه این دارد:
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
});
برای اتصال به درواره:
const client = new OpenAI({
apiKey: process.env.DARVAREH_API_KEY,
baseURL: "https://api.darvareh.ir/v1",
});
سپس Model ID را با شناسه مدل انتخابشده در درواره جایگزین کنید.
ممکن است برخی قابلیتهای اختصاصی مدلها با یکدیگر متفاوت باشند؛ بنابراین Streaming، Tool Calling، Structured Output، ورودی تصویر و پارامترهای پیشرفته را برای مدل انتخابشده آزمایش کنید.
اتصال ابزارهای سازگار با OpenAI
در ابزارهایی که امکان تعریف Provider سفارشی دارند، معمولاً این اطلاعات وارد میشوند:
Provider Type: OpenAI Compatible
Base URL: https://api.darvareh.ir/v1
API Key: کلید حساب درواره
Model ID: شناسه مدل از کاتالوگ
این الگو میتواند در ابزارهای دسکتاپ، محیطهای توسعۀ نرمافزار، سیستمهای Agent، پلتفرمهای RAG و ابزارهای اتوماسیون استفاده شود؛ مشروط بر اینکه ابزار از Base URL سفارشی پشتیبانی کند.
خطاهای رایج هنگام اتصال
خطای 401
دلایل احتمالی:
- API Key ارسال نشده است.
- کلید اشتباه است.
- کلید لغو یا غیرفعال شده است.
- قالب Authorization صحیح نیست.
قالب درست:
Authorization: Bearer YOUR_DARVAREH_API_KEY
خطای 404
دلایل احتمالی:
- Base URL اشتباه است.
/v1دوبار اضافه شده است.- Endpoint اشتباه است.
- Model ID معتبر نیست.
Base URL صحیح:
https://api.darvareh.ir/v1
خطای 429
دلایل احتمالی:
- عبور از Rate Limit
- درخواستهای همزمان زیاد
- عبور از محدودیت API Key
- مصرف بیش از بودجه
خطای کمبود موجودی
اگر موجودی کیف پول کافی نباشد، درخواست پیش از ارسال به مدل متوقف میشود. کیف پول را شارژ و وضعیت کلید را در داشبورد بررسی کنید.
پاسخ خالی
بررسی کنید:
- مدل Tool Call تولید نکرده باشد.
- پاسخ به محدودیت خروجی نرسیده باشد.
- ساختار
choicesوجود داشته باشد. - مدل از قابلیت موردنظر پشتیبانی کند.
- Streaming بهدرستی پردازش شده باشد.
چرا درواره برای کسبوکارهای ایرانی مناسب است؟
پرداخت ریالی
برای استفاده از مدلها نیاز به مدیریت پرداخت مستقیم به چند سرویس خارجی ندارید.
داشبورد فارسی
مدیریت حساب، کیف پول، کلیدها و مصرف در یک رابط فارسی انجام میشود.
دسترسی یکپارچه
مدلهای مختلف از طریق یک زیرساخت واحد قابلدسترسیاند.
مستندات فارسی
برای شروع و اتصال، راهنما و نمونهکد فارسی در اختیار توسعهدهندگان قرار میگیرد.
پشتیبانی
مشکلات فنی و مالی از طریق سیستم تیکت قابلپیگیری هستند.
گزارش مالی و مصرف
تیمها میتوانند هزینه و مصرف خود را در یک محیط مشاهده کنند.
کاهش پیچیدگی عملیاتی
نیازی نیست اتصال، پرداخت و API Key هر ارائهدهنده را جداگانه مدیریت کنید.
تفاوت درواره با اتصال مستقیم
| موضوع | اتصال مستقیم به چند ارائهدهنده | استفاده از درواره |
|---|---|---|
| تعداد حسابها | چند حساب | یک حساب |
| API Key | چند کلید | یک یا چند کلید داخلی قابلکنترل |
| پرداخت | چند پرداخت ارزی | کیف پول ریالی |
| ساختار API | متفاوت | رابط یکپارچه |
| داشبورد | پراکنده | داشبورد فارسی |
| گزارش مصرف | در چند سرویس | متمرکز |
| آزمایش مدل | چند Playground | محیط یکپارچه |
| تغییر مدل | احتمال تغییر کد زیاد | انتخاب مدل از طریق Model ID |
| پشتیبانی | پراکنده | تیکت درواره |
| کنترل بودجه | چند سیستم | مدیریت متمرکز |
| مستندات | منابع مختلف | مستندات فارسی |
| Fallback | نیازمند پیادهسازی | قابلمدیریت در زیرساخت |
تفاوت درواره با یک چتبات آماده
درواره یک چتبات آماده برای پاسخگویی به مشتریان نیست. محصول اصلی درواره زیرساخت API هوش مصنوعی است.
یک چتبات آماده معمولاً یک رابط نهایی در اختیار کاربر قرار میدهد. درواره API، داشبورد و ابزارهای توسعه را در اختیار برنامهنویس قرار میدهد تا قابلیت هوش مصنوعی را در محصول خودش بسازد.
چتبات آماده = محصول نهایی برای کاربر
درواره = زیرساخت ساخت محصولات هوش مصنوعی
البته آزمایشگاه و محیطهای آزمایشی درواره برای تست مدلها در دسترساند، اما ارزش اصلی پلتفرم در اتصال برنامهها به مدلهای مختلف از طریق API است.
تفاوت درواره با API Gateway عمومی
API Gateway عمومی درخواستهای HTTP را مدیریت میکند، اما درواره برای نیازهای اختصاصی هوش مصنوعی طراحی شده است:
- مدل
- توکن
- مصرف
- قیمت
- Streaming
- مسیر ارائهدهنده مدل
- جایگزینی خودکار مدل (Fallback)
- کاتالوگ مدل
- کیف پول
- گزارش هزینه
درواره را میتوان یک AI API Gateway دانست؛ یعنی دروازهای تخصصی برای اتصال نرمافزارها به اکوسیستم هوش مصنوعی.
آیا درواره باعث کاهش وابستگی به فروشنده میشود؟
استفاده از یک API سازگار و لایۀ یکپارچه میتواند وابستگی مستقیم به قرارداد یک ارائهدهنده را کاهش دهد.
اگر مدل فعلی برای نیاز شما مناسب نباشد، میتوانید مدل دیگری را بررسی کنید. در بسیاری از موارد، ساختار اصلی درخواست ثابت میماند و Model ID تغییر میکند.
بااینحال، سازگاری مدلها کامل نیست. موارد زیر باید پیش از تغییر مدل آزمایش شوند:
- کیفیت پاسخ
- Prompt
- Tool Calling
- Structured Output
- Context Window
- ورودی تصویر
- پارامترهای تولید
- سرعت
- قیمت
- سیاست ایمنی
امنیت در استفاده از درواره
کلید را در Backend نگهداری کنید
معماری پیشنهادی:
مرورگر یا اپلیکیشن
↓
Backend شما
↓
API درواره
↓
مدل هوش مصنوعی
برای هر پروژه کلید جدا بسازید
این کار لغو، کنترل و گزارشگیری را سادهتر میکند.
کلیدها را دورهای بررسی کنید
کلیدهای بلااستفاده را لغو کنید.
Secretها را در لاگ ثبت نکنید
Header مربوط به Authorization باید از لاگها حذف شود.
ورودی کاربر را کنترل کنید
برای جلوگیری از مصرف غیرعادی:
- طول ورودی را محدود کنید.
- Rate Limit اعمال کنید.
- Authentication داشته باشید.
- سقف بودجه تعریف کنید.
- خروجی را محدود کنید.
به خروجی مدل اعتماد کامل نکنید
خروجی مدل پیش از استفاده در عملیات حساس باید اعتبارسنجی شود.
راهکار پیشنهادی برای محیط عملیاتی
برای استفاده حرفهای:
- API Key را در Secret Manager قرار دهید.
- برای Development و Production کلید جدا بسازید.
- Model ID را در Config نگهداری کنید.
- Timeout مشخص تعریف کنید.
- Retry را فقط برای خطاهای موقت فعال کنید.
- Request ID را ثبت کنید.
- مصرف هر کاربر را جداگانه اندازهگیری کنید.
- سقف بودجه تعریف کنید.
- پاسخهای ساختاریافته را اعتبارسنجی کنید.
- برای مدل جایگزین تست داشته باشید.
- Streaming را هنگام قطع کاربر متوقف کنید.
- لاگها را از اطلاعات حساس پاک کنید.
چکلیست شروع سریع با درواره
- در سایت درواره ثبتنام کنید.
- پروفایل حساب را تکمیل کنید.
- در صورت نیاز شمارۀ موبایل را تأیید کنید.
- کیف پول را بهصورت ریالی شارژ کنید.
- وارد کاتالوگ مدلها شوید.
- Model ID مناسب را انتخاب کنید.
- یک API Key بسازید.
- کلید را در محیط امن ذخیره کنید.
- مدل را در Playground آزمایش کنید.
- Base URL را در برنامه تنظیم کنید.
- اولین درخواست را ارسال کنید.
- Usage و هزینه را در داشبورد بررسی کنید.
- برای محیط Production محدودیت بودجه و مصرف قرار دهید.
پرسشهای متداول
درواره چیست؟
درواره پلتفرم یکپارچۀ API هوش مصنوعی برای توسعهدهندگان و کسبوکارهای ایرانی است که دسترسی به صدها مدل را با یک حساب، کیف پول ریالی و API سازگار با OpenAI فراهم میکند.
درواره چه سرویسی ارائه میکند؟
سرویس اصلی درواره دسترسی API به مدلهای مختلف هوش مصنوعی همراه با داشبورد، کیف پول ریالی، مدیریت API Key، Playground، کاتالوگ مدل و گزارش مصرف است.
آیا درواره چتبات آماده میفروشد؟
محصول اصلی فعلی درواره زیرساخت API هوش مصنوعی است. توسعهدهندگان با استفاده از این API میتوانند چتبات، Agent، RAG و سایر محصولات هوشمند را بسازند.
Base URL درواره چیست؟
https://api.darvareh.ir/v1
احراز هویت چگونه انجام میشود؟
API Key از طریق Bearer Token ارسال میشود:
Authorization: Bearer YOUR_DARVAREH_API_KEY
آیا API درواره با OpenAI سازگار است؟
بله، مسیرهای اصلی API درواره از رابط سازگار با OpenAI استفاده میکنند. میزان پشتیبانی قابلیتهای پیشرفته به مدل و Endpoint انتخابشده بستگی دارد.
آیا میتوان از SDK رسمی OpenAI استفاده کرد؟
برای قابلیتهای سازگار، بله. کافی است api_key و base_url را با اطلاعات درواره تنظیم کنید.
آیا پرداخت درواره ریالی است؟
بله، کیف پول درواره از طریق پرداخت ریالی شارژ میشود و مصرف API از اعتبار کیف پول کسر خواهد شد.
آیا درواره اشتراک ماهانه دارد؟
مدل اصلی مصرف API مبتنی بر کیف پول و میزان استفاده است. جزئیات قیمت هر مدل را باید در کاتالوگ و داشبورد بررسی کنید.
آیا فقط به مدلهای متنی دسترسی داریم؟
خیر. کاتالوگ درواره شامل دستههای متن، تصویر، صوت، ویدئو، کدنویسی، Embedding، مدلهای چندوجهی و مدلهای تخصصی است.
آیا میتوان مدل را تغییر داد؟
بله. در درخواست API میتوانید Model ID دیگری را انتخاب کنید. سازگاری Prompt و قابلیتهای مدل جدید باید آزمایش شود.
آیا درواره Playground دارد؟
بله، میتوانید مدل و Prompt را پیش از پیادهسازی در محیط آزمایشی بررسی کنید.
آیا مصرف API قابلمشاهده است؟
بله، بخش Usage برای مشاهده و تحلیل مصرف و هزینه در دسترس است.
آیا برای هر پروژه میتوان API Key جدا ساخت؟
بله، بهتر است برای هر پروژه یا محیط یک کلید جدا ایجاد شود تا امنیت و گزارشگیری بهبود یابد.
اگر موجودی کیف پول تمام شود چه میشود؟
درخواستهای جدید بهدلیل کمبود اعتبار متوقف میشوند. پس از شارژ کیف پول، وضعیت کلیدهای متوقفشده بهعلت کمبود موجودی براساس سیاست حساب قابلبازیابی است.
آیا درواره از Streaming پشتیبانی میکند؟
بله، Streaming در مسیرها و مدلهای سازگار قابلاستفاده است.
آیا درواره برای RAG مناسب است؟
بله. میتوانید از مدلهای زبانی و Embedding موجود برای ساخت سیستم RAG استفاده کنید. مدیریت اسناد، Vector Database و Retrieval باید در معماری برنامۀ شما پیادهسازی شود.
آیا درواره برای Agent مناسب است؟
بله. مدلهای مناسب Tool Calling و استدلال میتوانند در معماری Agent استفاده شوند. اجرای ابزارها، حافظه، مجوزها و Loop عامل بر عهدۀ برنامۀ شما است.
آیا میتوان درواره را به ابزارهای دسکتاپ متصل کرد؟
اگر ابزار امکان تعریف OpenAI-Compatible Provider، Base URL سفارشی و API Key داشته باشد، امکان اتصال وجود دارد.
آیا API Key را میتوان در React قرار داد؟
خیر. کلید باید فقط در Backend نگهداری شود. قراردادن API Key در کد مرورگر باعث افشای آن میشود.
چگونه مدل مناسب را انتخاب کنیم؟
نوع وظیفه، کیفیت، سرعت، قیمت، Context Window، زبان فارسی و قابلیتهایی مانند Vision، Tool Calling و Structured Output را بررسی و چند مدل را با داده واقعی آزمایش کنید.
اگر با خطا روبهرو شویم چه کنیم؟
Request ID، زمان درخواست، Model ID و کد خطا را ثبت و از طریق سیستم تیکت پشتیبانی ارسال کنید. API Key کامل را در تیکت قرار ندهید.
همین حالا استفاده از درواره را شروع کنید
برای اضافه کردن هوش مصنوعی به محصول خود لازم نیست اتصال جداگانهای برای هر مدل و ارائهدهنده بسازید.
با درواره میتوانید:
- با پرداخت ریالی شروع کنید.
- از صدها مدل هوش مصنوعی استفاده کنید.
- یک API Key مرکزی داشته باشید.
- مدلها را در Playground آزمایش کنید.
- مصرف و هزینه را در داشبورد ببینید.
- از SDKها و ابزارهای سازگار با OpenAI استفاده کنید.
- مدل مناسب را متناسب با کیفیت، سرعت و هزینه انتخاب کنید.
سه قدم تا اولین درخواست
- در درواره ثبتنام کنید.
- کیف پول را شارژ و API Key ایجاد کنید.
- Base URL را در برنامه قرار دهید:
https://api.darvareh.ir/v1
درواره لایۀ اتصال نرمافزار شما به اکوسیستم هوش مصنوعی است:
یک اتصال، دسترسی به تمام اکوسیستم هوش مصنوعی
یک API Key برای تمام اکوسیستم هوش مصنوعی
همین حالا به درواره بپیوندید و زیرساخت هوش مصنوعی محصول خود را با پرداخت ریالی و API سازگار با OpenAI راهاندازی کنید.
مقالات مرتبط پیشنهادی
- API هوش مصنوعی چیست و چگونه از آن استفاده کنیم؟
- API سازگار با OpenAI چیست؟
- AI Gateway چیست و چه تفاوتی با API Gateway دارد؟
- API Gateway چیست؟ راهنمای جامع معماری و پیادهسازی
- بهترین API هوش مصنوعی برای سایت و اپلیکیشن
- آموزش اتصال به API درواره با Python، Node.js، PHP و Laravel
- چگونه ChatGPT را با API هوش مصنوعی به سایت اضافه کنیم؟
- آموزش اتصال ابزارهای دسکتاپ هوش مصنوعی به API درواره
- آموزش اتصال Dify و Flowise به API درواره
- آموزش اتصال n8n به API درواره
- آموزش اتصال Open WebUI به API درواره
- آموزش ساخت RAG با Embedding و API درواره