# مستندات اهوس‌ای‌آی

اهوس‌ای‌آی مدل‌های زبانی نیمبوس را توسعه می‌دهد و آن‌ها را از راه سه محصول ارائه می‌کند: استودیوی آنلاین، استودیوی آفلاین برای اجرا روی رایانهٔ شخصی، و یک API عمومی سازگار با قالب Chat Completions شرکت OpenAI. این مستندات آنچه را برای استفاده از این محصولات لازم است شرح می‌دهد.

## بخش‌ها {#sections}

- [مرجع API](api.html): نشانی سرویس، احراز هویت، قالب درخواست و پاسخ، پخش زنده، ابزارها و خطاها.
- [قوانین و محدودیت‌های API](rules.html): سقف مصرف، کلیدهای API، استفادهٔ مجاز و نحوهٔ نگهداری داده‌ها.
- [مدل‌ها](models.html): مدل‌های در دسترس و ورودی‌هایی که می‌پذیرند.
- [استودیو](studio.html): استودیوی آنلاین و استودیوی آفلاین.

## یک حساب برای همه {#account}

همهٔ سرویس‌های آنلاین با یک ورود در [ahoos-ai.site/services](https://ahoos-ai.site/services/) در دسترس‌اند. با ورود به حساب، به استودیوی آنلاین، پلتفرم ساخت کلیدهای API و آمار مصرف خود دسترسی خواهید داشت. استودیوی آفلاین به حساب کاربری نیاز ندارد.

## شروع سریع {#quick-start}

1. در [ahoos-ai.site/services](https://ahoos-ai.site/services/) وارد حساب خود شوید.
2. [پلتفرم](https://ahoos-ai.site/services/platforme/) را باز کنید و یک کلید API بسازید. کلید فقط یک بار نمایش داده می‌شود؛ آن را در جای امنی نگه دارید.
3. یک درخواست ارسال کنید:

```bash
curl https://ahoos-ai.site/services/api/v1/chat/completions \
  -H "Authorization: Bearer nim_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "nimbus-2-apex", "messages": [{"role": "user", "content": "سلام"}]}'
```

نخستین درخواست پس از مدتی بی‌استفاده ماندن سرویس، ممکن است تا دو دقیقه طول بکشد تا مدل راه‌اندازی شود. درخواست‌های بعدی بی‌درنگ آغاز می‌شوند.

## برای ابزارهای هوش مصنوعی {#ai-tools}

هر صفحه از این مستندات به‌صورت Markdown ساده نیز منتشر شده است: کافی است در نشانی صفحه، `.html` را با `.en.txt` یا `.fa.txt` جایگزین کنید (برای نمونه [api.fa.txt](api.fa.txt)). فهرست سایت برای مدل‌های زبانی در [/llms.txt](https://ahoos-ai.site/llms.txt) در دسترس است.

## تماس {#contact}

پرسش‌ها و گزارش‌ها: [Support@ahoos-ai.site](mailto:Support@ahoos-ai.site) یا [فرم تماس](https://ahoos-ai.site/contact/).