راهنمای توسعه‌دهندگان یارابات

یکپارچه‌سازی و توسعه خلاقانه به کمک API پایدار یارابات

همه‌ی مدل‌ها را از طریق یک کلید API امن و یک نقطه‌ی اتصال واحد فراخوانی کنید؛ بدون درگیری با پرداخت بین‌المللی یا برپایی پروکسی.

تنظیمات شبیه‌ساز درخواست

انتخاب مدل هدف درخواست:

خلاقیت (Temperature)0.7

0.01.02.0

حداکثر توکن (Max Token)2048

1620484096

پاسخ متنی زنده (stream) فعال باشد

با کلیک روی دکمه ورود، کلید API آزمایشی و اختصاصی خود را بسازید.← ایجاد کلید API در پنل

# نمونه درخواست POST به درگاه یارابات

curl -X POST https://backend.yarabot.ir/api/v1/public/chat/completion \
  -H "Authorization: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-lite-preview",
    "temperature": 0.7,
    "max_completion_tokens": 2048,
    "stream": true
  }'

راهنمای فیلدهای فنی درخواست

Authorization (Header):

کلید API خود را با عنوان Bearer در هدر ارسال کنید تا به حساب شما متصل گردد (دریافت کلید با نام نویسی آزمایشی در پرتال به نشانی app.yarabot.ir).

model (Body - string):

شناسه مدل هدف (مثلاً google/gemini-3.1-flash-lite-preview) که هزینه پیام بر پایه‌ی تعرفه‌ی دقیق کارتی آن از کیف پول کسر می‌شود.

history (Body - array):

لیست آرایه‌ای از پیام‌های رد و بدل شده قبلی برای شبیه‌سازی دقیق حافظه چت‌بات با ساختار استاندارد شامل role و content.

stream (Body - boolean):

اگر روی true ست شود، پاسخ‌ها کاراکتر به کاراکتر با استاندارد Server-Sent Events (SSE) برمی‌گردند تا تجربه کاربری بسیار روانی خلق کنند.