مستندات API درواره
با API درواره میتوانید برنامه، چتبات یا اتوماسیون خود را به دهها مدل هوش مصنوعی وصل کنید. این API کاملاً سازگار با OpenAI است؛ کافی است سه چیز را تغییر دهید.
سازگاری با OpenAI
اگر از SDK رسمی OpenAI استفاده میکنید، فقط این سه مقدار را تغییر دهید:
base_url→https://api.darvareh.ir/v1api_key→ کلید API درواره (dv_live_…)model→ نام مدل موردنظر از صفحۀ مدلها
from openai import OpenAI
client = OpenAI(
api_key="YOUR_DARVAREH_API_KEY",
base_url="https://api.darvareh.ir/v1",
)
resp = client.chat.completions.create(
model="gpt-5.5",
messages=[{"role": "user", "content": "سلام درواره!"}],
)
print(resp.choices[0].message.content)اندپوینتهای پشتیبانیشده
همۀ اندپوینتهای زیر با استاندارد OpenAI سازگارند و روی همان آدرس پایه ارائه میشوند.
شروع سریع
ساخت حساب، شارژ کیف پول و ارسال اولین درخواست.
احراز هویت
استفاده از کلید API در هدر Authorization.
Chat Completions
اندپوینت اصلی برای گفتوگو با مدلهای زبانی.
استریم پاسخ
دریافت پاسخ مرحلهبهمرحله با SSE.
Function / Tool Calling
فراخوانی توابع و ابزارها توسط مدل.
Embeddings
تبدیل متن به بردار برای جستوجوی معنایی.
Image Generation
تولید تصویر از متن.
Text-to-Speech
تبدیل متن به گفتار.
Speech-to-Text
تبدیل صوت به متن.
Rerank
مرتبسازی مجدد نتایج جستوجو.
Moderations
بررسی محتوای حساس.
فهرست مدلها
بازیابی مدلهای در دسترس شما.
محدودیت مصرف
RPM، TPM، بودجه و مدلهای مجاز.
خطاها
کدها، معنا و راهحل.
مدیریت هزینه
محاسبۀ هزینه، نرخ ارز و حاشیۀ همکار.
نمونه کدها
cURL، JavaScript، Python، PHP و …
نقشۀ اندپوینتها
POST https://api.darvareh.ir/v1/chat/completions
POST https://api.darvareh.ir/v1/completions
POST https://api.darvareh.ir/v1/embeddings
POST https://api.darvareh.ir/v1/images/generations
POST https://api.darvareh.ir/v1/audio/speech
POST https://api.darvareh.ir/v1/audio/transcriptions
POST https://api.darvareh.ir/v1/audio/translations
POST https://api.darvareh.ir/v1/rerank
POST https://api.darvareh.ir/v1/moderations
GET https://api.darvareh.ir/v1/models