صفحه اختصاصی Provider
Vercel AI Gateway API رایگان
اطلاعات Vercel AI Gateway: سهمیه رایگان، روش اتصال (Endpoint مستقیم در دسترس است) و پیش‌نیاز حساب (نیاز به کارت بانکی بین‌المللی) با منبع و تاریخ بررسی.
خلاصه فنی
- نوع سهمیه
- اعتبار ماهانه
- محدودیت نمونه
- $5 در ماه
- سازگار با OpenAI
- بله
- روش اتصال از ایران
- Endpoint مستقیم در دسترس است
- پیش‌نیاز حساب
- نیاز به کارت بانکی بین‌المللی
- Base URL
https://ai-gateway.vercel.sh/v1
قابلیت‌ها
مدل‌های شاخص
فهرست مدل‌ها پویا است؛ منبع رسمی را بررسی کنید.
نکات مهم
اعتبار رایگان ماهانه ۵ دلار روی مدل‌های واجد شرایط. اما Vercel حتی برای فعال‌سازی اعتبار رایگان نیز کارت اعتباری معتبر می‌خواهد (HTTP 403: customer_verification_required). ثبت‌نام نیاز به حساب Vercel دارد.
ثبت‌نام، صدور کلید و مصرف اعتبار از شبکهٔ ایران هنوز با درخواست مدل معتبر آزمایش نشده است.
کلید API معتبر است (306 مدل قابل دسترس). اما Vercel برای سرویس‌دهی نیاز به کارت اعتباری روی حساب دارد (حتی برای اعتبار رایگان ماهانه ۵ دلار). آزمایش استنتاج از ایران به همین دلیل انجام نشد.
هدف استفاده و نیت جست‌وجو
Vercel AI Gateway برای استفاده از مدل‌های چند Provider با یک API Key، endpoint سازگار با OpenAI، fallback و مشاهده مصرف مناسب است. هر Team واجد شرایط اعتبار ماهانه محدود دارد، هزینه بر اساس مدل و توکن از Credits کم می‌شود و خرید Credit حساب را به حالت پولی منتقل می‌کند. وضعیت ایران در Catalog نامشخص است: endpoint مدل‌ها Reachable بوده، اما درخواست مدل با Gateway Key معتبر هنوز ثبت نشده است.
مراحل ثبت‌نام
- یک حساب و Team در Vercel بسازید، AI Gateway را باز کنید و از بخش API Keys یک کلید جدید ایجاد کنید. کلید را فقط در AI_GATEWAY_API_KEY یا secret manager نگهداری کنید.
- برای جلوگیری از مصرف ناخواسته، هنگام ساخت یا ویرایش کلید یک Spend Quota متناسب با Prototype تعیین کنید. سقف کلید جای کنترل هزینه در سطح Team و انتخاب مدل کم‌هزینه را نمی‌گیرد.
- مدل را از Catalog رسمی Gateway انتخاب و یک درخواست کوتاه ارسال کنید. اعتبار رایگان پس از اولین درخواست در چرخه ۳۰روزه اعمال می‌شود؛ موجودی و مدل‌های قابل استفاده را از Dashboard همان Team کنترل کنید.
نمونه اولین درخواست API
curl https://ai-gateway.vercel.sh/v1/chat/completions \
-H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"openai/gpt-5.4","messages":[{"role":"user","content":"سلام! در یک جمله پاسخ بده."}],"stream":false}'شناسه مدل و قیمت آن را از Catalog رسمی Vercel بردارید. مدل نمونه ممکن است در Free Credit یا منطقه حساب محدود شود؛ پیش از استفاده، موجودی Credits و دسترسی واقعی همان Team را بررسی کنید.
منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16
خطاهای رایج و رفع اشکال
- 401/403 — کلید، مجوز Team یا مدل قابل استفاده نیست
AI_GATEWAY_API_KEY و هدر Bearer را بررسی کنید، کلید را در Team درست بسازید و محدودیت مدل یا Free Credit را از Dashboard ببینید. پاسخ ۲۰۰ /models از ایران فقط Reachability است و نتیجه inference را ثابت نمی‌کند. منبع رسمی (2026-07-16)
- 402/budget — Credits یا بودجه کلید تمام شده است
موجودی AI Gateway Credits و Spend Quota کلید را بررسی کنید. retry خودکار موجودی یا budget را افزایش نمی‌دهد؛ مدل ارزان‌تر انتخاب کنید یا مصرف را تا reset اعتبار متوقف کنید. منبع رسمی (2026-07-16)
- 404/429/5xx — مدل یافت نشد، Rate Limit یا Provider بالادستی خطا داد
شناسه مدل را با Catalog رسمی تطبیق دهید، concurrency را کم و retry را با backoff اجرا کنید. fallback و ترتیب Provider را آگاهانه تنظیم کنید؛ loop بی‌پایان می‌تواند Credits را مصرف یا خطای Provider را پنهان کند. منبع رسمی (2026-07-16)
چه زمانی این Provider انتخاب مناسبی نیست؟
- زمانی که پروژه به Provider ثابت، قرارداد مستقیم یا کنترل کامل مسیر پردازش داده نیاز دارد و routing چندارائه‌دهنده‌ای پذیرفتنی نیست.
- زمانی که اعتبار رایگان باید برای همیشه بدون تغییر وضعیت حساب باقی بماند؛ خرید Credits حساب را به pay-as-you-go منتقل می‌کند و Free Credit ماهانه متوقف می‌شود.
- زمانی که دسترسی مستقیم تأییدشده از ایران شرط انتخاب است؛ Evidence فعلی فقط Reachability /models را نشان می‌دهد و درخواست مدل معتبر هنوز انجام نشده است.
راهنماهای مرتبط
آخرین بازبینی محتوای این صفحه: 2026-07-16