API رایگان برای برنامه‌نویسی
هدف این راهنما و نیت جست‌وجو
این صفحه برای توسعه‌دهنده‌ای است که یک API رایگان یا دارای سهمیه رایگان برای تولید کد، توضیح خطا، خروجی ساخت‌یافته یا Tool Calling می‌خواهد. وجود نام یک مدل کدنویسی به‌تنهایی کافی نیست؛ Endpoint، محدودیت مصرف، امکان ساخت حساب و وضعیت دسترسی از ایران باید جداگانه بررسی شوند.
مقایسه Providerهای دارای قابلیت مرتبط
| Provider | نوع دسترسی رایگان | محدودیت ثبت‌شده | وضعیت ایران | آخرین بررسی |
|---|---|---|---|---|
| Agnes AI | مدل‌های رایگان | 20 RPM | ✅ مستقیم تست‌شده | 2026-07-24 |
| Cerebras Inference | دوره آزمایشی | 5 RPM · 30000 TPM | ⛔ محدودیت جغرافیایی تأییدشده | 2026-07-20 |
| Cloudflare Workers AI | سهمیه رایگان دائمی | وابسته به مدل یا حساب | ✅ مستقیم تست‌شده | 2026-07-20 |
| Cohere | دوره آزمایشی | 20 RPM · 1000 درخواست در ماه | ⛔ محدودیت جغرافیایی تأییدشده | 2026-07-20 |
| Fireworks AI | اعتبار یک‌باره | وابسته به مدل یا حساب | 🧾 مانع ثبت‌نام | 2026-08-07 |
| FreeTheAI | مدل‌های رایگان | 10 RPM · 250 RPD | 🧾 مانع ثبت‌نام | 2026-08-05 |
| GitHub Models | سهمیه رایگان دائمی | 15 RPM · 150 RPD | ✅ مستقیم تست‌شده | 2026-07-20 |
| Google Gemini API | سهمیه رایگان دائمی | وابسته به مدل یا حساب | 🚫 پشتیبانی‌نشده رسمی | 2026-07-20 |
| Groq | سهمیه رایگان دائمی | 30 RPM · 1000 RPD · 8000 TPM | ⛔ محدودیت جغرافیایی تأییدشده | 2026-07-20 |
| Hugging Face Inference Providers | اعتبار رایگان ماهانه | $0.1 اعتبار ماهانه | ✅ مستقیم تست‌شده | 2026-07-24 |
| Kilo Gateway | مدل‌های رایگان | 200 RPH | ✅ مستقیم تست‌شده | 2026-07-24 |
| LLM7.io | مدل‌های رایگان | 30 RPM | ✅ مستقیم تست‌شده | 2026-08-05 |
| Mistral AI | سهمیه رایگان دائمی | وابسته به مدل یا حساب | ✅ مستقیم تست‌شده | 2026-07-24 |
| ModelScope (Alibaba) | مدل‌های رایگان | 2000 RPD | 🧾 مانع ثبت‌نام | 2026-08-05 |
| NVIDIA NIM API Catalog | سهمیه رایگان دائمی | وابسته به مدل یا حساب | 🧾 مانع ثبت‌نام | 2026-07-21 |
| OpenCode Zen | مدل‌های رایگان | وابسته به مدل یا حساب | ✅ مستقیم تست‌شده | 2026-08-05 |
| OpenRouter | مدل‌های رایگان | 20 RPM · 50 RPD | ⛔ محدودیت جغرافیایی تأییدشده | 2026-07-20 |
| SambaNova Cloud | سهمیه رایگان دائمی | 20 RPM · 20 RPD | ✅ مستقیم تست‌شده | 2026-07-24 |
| SiliconFlow | مدل‌های رایگان | 30 RPM · 60000 TPM | 🧾 مانع ثبت‌نام | 2026-07-20 |
| Vercel AI Gateway | اعتبار رایگان ماهانه | $5 اعتبار ماهانه | 🧾 مانع ثبت‌نام | 2026-07-21 |
مراحل ثبت‌نام امن
- از جدول بالا وارد صفحه اختصاصی Provider شوید و تاریخ آخرین بررسی را کنترل کنید.
- فقط از لینک مستندات رسمی همان Provider وارد فرایند ثبت‌نام شوید.
- شرایط کشور، نیاز به روش پرداخت و محدودیت حساب رایگان را پیش از ساخت کلید بخوانید.
- کلید API را فقط در Secret Manager یا متغیر محیطی ذخیره کنید؛ آن را در Git، Screenshot یا پیام عمومی قرار ندهید.
نمونه اولین درخواست API
نمونه زیر فقط برای Provider سازگار با OpenAI است. Base URL و شناسه مدل باید با مستندات رسمی حساب شما تطبیق داده شود.
export LLM_API_KEY="..."
export LLM_BASE_URL="https://apihub.agnes-ai.com/v1"
export LLM_MODEL="agnes-2.0-flash"
curl "$LLM_BASE_URL/chat/completions" \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$LLM_MODEL"'",
"messages": [{"role": "user", "content": "یک تابع امن برای اعتبارسنجی ایمیل بنویس"}],
"temperature": 0.2
}'پاسخ موفق باید محتوای مدل را برگرداند؛ پاسخ ۲۰۰ از صفحه اصلی یا Endpoint عمومی، اجرای واقعی مدل را ثابت نمی‌کند.
سهمیه و محدودیت‌ها
برای ابزارهای Coding علاوه بر RPM و RPD، طول Context، سقف خروجی، محدودیت Tool Calling و مدل‌های مجاز حساب رایگان مهم‌اند. مقدارهای جدول از Catalog فعلی می‌آیند و ممکن است با سیاست Provider تغییر کنند؛ قبل از استفاده در CI یا محصول، منبع رسمی و تاریخ بررسی را دوباره کنترل کنید.
وضعیت ایران و شواهد دسترسی
برچسب‌های جدول بین «دسترسی مستقیم تست‌شده»، «VPN»، «مانع ثبت‌نام»، «محدودیت رسمی» و «نامشخص» تفاوت می‌گذارند. Reachability شبکه، ساخت حساب و درخواست واقعی مدل سه Evidence جدا هستند؛ هیچ‌کدام را از دیگری استنباط نکنید.
خطاهای رایج و رفع اشکال
- 401: کلید اشتباه، منقضی یا متعلق به محیط دیگری است؛ Secret و Header را بررسی کنید.
- 403: محدودیت کشور، حساب، مدل یا Policy محتمل است؛ از تغییر مکرر Endpoint بدون خواندن پیام خطا خودداری کنید.
- 404 یا model not found: شناسه مدل یا Base URL با مستندات Provider هماهنگ نیست.
- 429: RPM، TPM یا سهمیه روزانه تمام شده است؛ Backoff نمایی و Queue اضافه کنید.
- خروجی JSON نامعتبر: Structured Output را فقط وقتی استفاده کنید که Provider و مدل آن را صریحاً پشتیبانی کنند.
چه زمانی این گزینه مناسب نیست؟
اگر به SLA، نگهداری طولانی Context، اجرای پایدار Agent، پردازش داده حساس یا Tool Calling کاملاً سازگار نیاز دارید، صرفاً رایگان‌بودن معیار مناسبی نیست. برای Production باید هزینه خروج از سهمیه رایگان، سیاست داده، Failover و محدودیت مدل را نیز ارزیابی کنید.
منابع رسمی تاریخ‌دار
- Agnes AI — مستندات رسمی — تاریخ بررسی داده: 2026-07-24
- Cerebras Inference — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- Cloudflare Workers AI — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- Cohere — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- Fireworks AI — مستندات رسمی — تاریخ بررسی داده: 2026-08-07
- FreeTheAI — مستندات رسمی — تاریخ بررسی داده: 2026-08-05
- GitHub Models — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- Google Gemini API — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- Groq — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- Hugging Face Inference Providers — مستندات رسمی — تاریخ بررسی داده: 2026-07-24
- Kilo Gateway — مستندات رسمی — تاریخ بررسی داده: 2026-07-24
- LLM7.io — مستندات رسمی — تاریخ بررسی داده: 2026-08-05
- Mistral AI — مستندات رسمی — تاریخ بررسی داده: 2026-07-24
- ModelScope (Alibaba) — مستندات رسمی — تاریخ بررسی داده: 2026-08-05
- NVIDIA NIM API Catalog — مستندات رسمی — تاریخ بررسی داده: 2026-07-21
- OpenCode Zen — مستندات رسمی — تاریخ بررسی داده: 2026-08-05
- OpenRouter — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- SambaNova Cloud — مستندات رسمی — تاریخ بررسی داده: 2026-07-24
- SiliconFlow — مستندات رسمی — تاریخ بررسی داده: 2026-07-20
- Vercel AI Gateway — مستندات رسمی — تاریخ بررسی داده: 2026-07-21