راهنمای ابریها

• در صفحه ثبت‌نام با ایمیل (یا حساب گوگل) حساب بسازید؛ حساب جدید روی پلن رایگان است.
• پس از ثبت‌نام، کدی که به ایمیل و موبایل‌تان فرستاده می‌شود را وارد کنید تا تأیید شوند.
• برای سرویس‌های پولی کیف پول را شارژ کنید؛ همه سرویس‌ها از همین کیف پول پرداخت می‌شوند.

افزودن دامنه:

• در «دامنه‌ها» روی «افزودن دامنه» بزنید و نام دامنه را وارد کنید. رکوردهای DNS فعلی خودکار خوانده و وارد می‌شوند؛ آن‌ها را بازبینی کنید.
• دو نیم‌سرور اختصاصی حساب‌تان را در پنل ثبت‌کننده دامنه جایگزین نیم‌سرورهای فعلی کنید.
• پس از تغییر نیم‌سرورها، دامنه خودکار فعال می‌شود و گواهی SSL رایگان برای دامنه و زیردامنه‌ها صادر می‌شود. انتشار نیم‌سرور ممکن است تا چند ساعت طول بکشد.

تنظیمات هر دامنه در زبانه‌های پنل:

• DNS: افزودن و ویرایش رکوردها. رکوردهایی که «پروکسی CDN» آن‌ها روشن است از شبکه لبه سرو می‌شوند؛ برای هر رکورد می‌توانید پروتکل، پورت و هدر Host سرور اصلی را جدا تعیین کنید.
• SSL: حالت اتصال به سرور اصلی. «انعطاف‌پذیر» با HTTP به سرور اصلی وصل می‌شود و «کامل» با HTTPS؛ اگر سرور اصلی فقط HTTPS دارد «کامل» را انتخاب کنید.
• کش: پاک‌سازی کل کش یا مسیرهای مشخص روی همه سرورهای لبه در چند ثانیه.

• در «کانتینر» روی «اپلیکیشن جدید» بزنید.
• نام اپلیکیشن را انتخاب کنید؛ آدرس آن ‎<name>.apps.abrihaa.ir‎ با SSL رایگان خواهد بود.
• ایمیج داکر (مثلاً nginx:alpine)، پورتی که اپلیکیشن داخل کانتینر روی آن گوش می‌دهد و در صورت نیاز مسیر بررسی سلامت و دستور شروع را وارد کنید.
• پلن را انتخاب کنید و «ساخت و استقرار» را بزنید.

پس از ساخت: در زبانه «متغیرها» متغیرهای محیطی را تعریف کنید (رمزنگاری‌شده ذخیره می‌شوند)، در «لاگ‌ها» خروجی زنده را ببینید و از «استقرار» نسخه جدید ایمیج را منتشر کنید. اگر نسخه جدید بالا نیاید، نسخه قبلی سر جایش می‌ماند. تعداد نسخه‌های در حال اجرا را در «نمای کلی» تغییر دهید؛ هزینه به ازای هر نسخه است.

API ابریها با OpenAI سازگار است؛ با کتابخانه‌ای که امروز استفاده می‌کنید کار می‌کند.

• در «هوش مصنوعی» ← «کلیدهای API» کلید بسازید. برای هر کلید می‌توانید سقف هزینه ماهانه تعیین کنید.
• آدرس پایه: https://api.abrihaa.ir/api/ai/v1
• نام مدل را از فهرست مدل‌های فعال در صفحه تعرفه‌ها یا پنل بردارید.
• مسیرهای پشتیبانی‌شده: chat/completions، embeddings، images/generations، audio/speech، audio/transcriptions و videos.

curl https://api.abrihaa.ir/api/ai/v1/chat/completions \
  -H "Authorization: Bearer $ABRIHAA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "Hello"}]}'

from openai import OpenAI

client = OpenAI(base_url="https://api.abrihaa.ir/api/ai/v1", api_key="YOUR_ABRIHAA_KEY")
r = client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Hello"}])
print(r.choices[0].message.content)

هر کلید به‌طور پیش‌فرض تا ۲۴۰ درخواست در دقیقه پاسخ می‌گیرد. هزینه و جزئیات هر درخواست در «هوش مصنوعی» ← «مصرف» دیده می‌شود.

در پنل، «چت هوش مصنوعی» بدون کلید API با مدل‌ها کار می‌کند: مدل را انتخاب کنید، پیام بنویسید یا با میکروفون حرف بزنید، تصویر پیوست کنید (برای مدل‌هایی که تصویر می‌پذیرند)، تصویر و ویدیو بسازید و پاسخ را با صدا بشنوید. در تنظیمات هر گفتگو می‌توانید دستورالعمل اختصاصی بنویسید. گفتگوها ذخیره می‌شوند و هزینه هر گفتگو کنار آن نمایش داده می‌شود. ویدیوها حدود ۲۴ ساعت در دسترس‌اند؛ آن‌ها را دانلود کنید.

• CDN: پلن ماهانه. اگر موجودی کیف پول منفی شود، دامنه‌های پلن پولی تا شارژ کیف پول پاسخ ۴۰۲ می‌دهند؛ با شارژ، سرویس در چند ثانیه برمی‌گردد.
• کانتینر: ساعتی به ازای هر نسخه. برای ساخت یا روشن‌کردن اپلیکیشن، موجودی باید هزینه ۲۴ ساعت را پوشش دهد. با تمام‌شدن موجودی، اپلیکیشن‌های پولی متوقف و پس از شارژ دوباره روشن می‌شوند.
• هوش مصنوعی: بر اساس مصرف؛ با موجودی ناکافی پاسخ ۴۰۲ برمی‌گردد.

خطاهای رایج API هوش مصنوعی: ۴۰۱ کلید نادرست یا لغوشده، ۴۰۲ موجودی ناکافی، ۴۰۴ نام مدل نادرست یا مدل غیرفعال، ۴۲۹ رسیدن به سقف درخواست یا سقف هزینه کلید، ۵۰۲ در دسترس نبودن موقت سرویس‌دهنده مدل.