صفحه اختصاصی Provider
Groq API رایگان
اطلاعات Groq: سهمیه رایگان، روش اتصال (اتصال مستقیم برقرار نشد) و پیش‌نیاز حساب (بدون نیاز به کارت بانکی بین‌المللی) با منبع و تاریخ بررسی.
خلاصه فنی
- نوع سهمیه
- سهمیه دائمی
- محدودیت نمونه
- 30 RPM · 1000 RPD · 8000 TPM
- سازگار با OpenAI
- بله
- روش اتصال از ایران
- اتصال مستقیم برقرار نشد
- پیش‌نیاز حساب
- بدون نیاز به کارت بانکی بین‌المللی
- Base URL
https://api.groq.com/openai/v1
قابلیت‌ها
مدل‌های شاخص
openai/gpt-oss-20b، openai/gpt-oss-120b، qwen/qwen3.6-27b
نکات مهم
سهمیه‌ها در سطح Organization اعمال می‌شوند و مدل‌به‌مدل متفاوت‌اند. مدل qwen/qwen3-32b طبق صفحه رسمی Deprecation در ۱۷ ژوئیه ۲۰۲۶ خاموش شد و از فهرست نمونه حذف شده است؛ صفحه Limits حساب مرجع نهایی است.
درخواست زنده از مسیر مستقیم ایران پاسخ ۴۰۳ داد و همان کلید از منطقهٔ پشتیبانی‌شده پاسخ ۲۰۰ گرفت؛ مسدودیت جغرافیایی در تاریخ ثبت‌شده تأیید شد. مدل‌ها و سهمیه‌های نمونه در ۱۸ ژوئیه ۲۰۲۶ با صفحات رسمی Limits و Deprecation تطبیق داده شدند.
مسدودیت جغرافیایی تأیید شد. کلید معتبر از سرور خارج ایران ۲۰۰ برگرداند.
هدف استفاده و نیت جست‌وجو
Groq برای توسعه‌دهنده‌ای مناسب است که یک API سازگار با OpenAI برای چت، تولید متن، استدلال، Tool Calling یا خروجی ساخت‌یافته می‌خواهد و سرعت پاسخ برای نمونه‌سازی، ابزارهای برنامه‌نویسی یا سرویس‌های تعاملی اهمیت دارد. وضعیت سهمیه و دسترسی ایران باید از خلاصه فنی و Evidence تاریخ‌دار همین صفحه خوانده شود.
مراحل ثبت‌نام
- از صفحه رسمی GroqCloud وارد حساب شوید و در بخش API Keys یک کلید جدید بسازید.
- کلید را در متغیر محیطی GROQ_API_KEY یا Secret Manager سمت سرور ذخیره کنید و آن را در کد، مرورگر یا مخزن Git قرار ندهید.
- پیش از انتخاب مدل، صفحه Models و Limits حساب را بررسی کنید؛ محدودیت‌ها در سطح Organization و به‌ازای مدل اعمال می‌شوند.
نمونه اولین درخواست API
curl https://api.groq.com/openai/v1/chat/completions \
-H "Authorization: Bearer ${GROQ_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"model":"llama-3.1-8b-instant","messages":[{"role":"user","content":"یک پاسخ کوتاه فارسی بنویس"}]}'نمونه از Endpoint سازگار با OpenAI و متغیر محیطی استفاده می‌کند. شناسه مدل باید با صفحه Models و مجوزهای حساب شما تطبیق داده شود.
منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16
خطاهای رایج و رفع اشکال
- 401 — کلید API نامعتبر یا ارسال‌نشده
وجود متغیر GROQ_API_KEY را در همان محیط اجرای برنامه بررسی کنید، هدر Bearer را درست بسازید و در صورت لغو یا افشای کلید، آن را جایگزین کنید. منبع رسمی (2026-07-16)
- 403 — درخواست مجاز نیست یا محدودیت دسترسی وجود دارد
مجوز مدل و حساب را بررسی کنید و وضعیت دسترسی ایران را با Evidence همین صفحه تطبیق دهید. چند بار تکرار درخواست، مشکل مجوز یا محدودیت جغرافیایی را رفع نمی‌کند. منبع رسمی (2026-07-16)
- 429 — عبور از Rate Limit سازمان یا مدل
هدر Retry-After و هدرهای x-ratelimit را بخوانید، درخواست‌ها را صف‌بندی کنید و Retry را با Backoff و Jitter انجام دهید؛ ساخت کلید جدید سهمیه Organization را افزایش نمی‌دهد. منبع رسمی (2026-07-16)
چه زمانی این Provider انتخاب مناسبی نیست؟
- وقتی وضعیت دسترسی نمایش‌داده‌شده در همین صفحه با مسیر شبکه و الزامات پروژه شما سازگار نیست.
- وقتی بدون بررسی مدل و محدودیت حساب، به ظرفیت ثابت و SLA تضمین‌شده برای بار تولیدی نیاز دارید.
- وقتی برنامه باید کلید API را مستقیماً در مرورگر یا اپلیکیشن موبایل نگهداری کند؛ در این حالت یک Backend امن لازم است.
راهنماهای مرتبط
آخرین بازبینی محتوای این صفحه: 2026-07-16