Mistral AI API رایگان

هدف استفاده و نیت جست‌وجو

Mistral AI برای نمونه‌سازی چت، استدلال، Embedding و Tool Calling با API رسمی و سازگار با الگوی OpenAI مناسب است. این صفحه برای کاربری نوشته شده که می‌خواهد کلید API بسازد، نخستین درخواست امن را ارسال کند و بداند سهمیه حساب و نتیجه دسترسی مستقیم از ایران باید همیشه با تاریخ و منبع دوباره بررسی شوند.

مراحل ثبت‌نام

1. از مسیر رسمی Mistral Studio حساب بسازید یا وارد شوید و Free mode را برای استفاده محدود فعال نگه دارید؛ محدودیت نهایی همان مقداری است که در صفحه Limits حساب نمایش داده می‌شود.
2. در بخش API Keys یک کلید جدید با نام و تاریخ انقضای مناسب بسازید و آن را فقط در متغیر محیطی MISTRAL_API_KEY نگهداری کنید؛ کلید را داخل کد مرورگر، مخزن Git یا فایل عمومی قرار ندهید.
3. پیش از استفاده عملی، مدل انتخابی را در فهرست رسمی مدل‌ها کنترل کنید و یک درخواست کوچک آزمایشی بفرستید تا وضعیت کلید، مدل و سهمیه همان حساب مشخص شود.

نمونه اولین درخواست API

curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"mistral-small-latest","messages":[{"role":"user","content":"سلام! در یک جمله پاسخ بده."}]}'

کلید واقعی باید فقط از متغیر محیطی خوانده شود. نام مدل و محدودیت حساب ممکن است تغییر کند؛ در صورت خطای مدل، فهرست رسمی و صفحه Limits کنسول را بررسی کنید.

منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16

خطاهای رایج و رفع اشکال

• 401 — کلید نامعتبر یا ارسال‌نشده

  وجود MISTRAL_API_KEY، هدر Authorization و فعال‌بودن کلید در Studio را بررسی کنید و هرگز مقدار کلید را در لاگ یا پیام خطا منتشر نکنید. منبع رسمی (2026-07-16)

• 422 — بدنه درخواست یا مدل نامعتبر

  ساختار messages، نوع فیلدها و شناسه دقیق مدل را با مستندات فعلی تطبیق دهید؛ یک درخواست حداقلی به تشخیص فیلد مشکل‌دار کمک می‌کند. منبع رسمی (2026-07-16)

• 429 — عبور از محدودیت حساب

  نرخ درخواست و حجم توکن را کاهش دهید، retry را با exponential backoff و jitter اجرا کنید و مقدار واقعی محدودیت را از صفحه Limits همان حساب بخوانید. منبع رسمی (2026-07-16)

چه زمانی این Provider انتخاب مناسبی نیست؟

• زمانی که پروژه به یک عدد عمومی و تضمین‌شده برای سهمیه رایگان نیاز دارد، زیرا مقدار دقیق Free mode در حساب و صفحه Limits نمایش داده می‌شود.
• زمانی که بار تولیدی سنگین، SLA قراردادی یا ظرفیت رزروشده لازم است و پلن رایگان محدود برای این هدف کافی نیست.
• زمانی که انتخاب پروژه به یک مدل ثابت و بدون تغییر وابسته است؛ پیش از استقرار باید چرخه عمر و فهرست مدل‌ها جداگانه کنترل شود.

راهنماهای مرتبط

• openai-sdk-custom-base-url
• free-tier-vs-trial-vs-credit
• best-free-llm-api-iran

آخرین بازبینی محتوای این صفحه: 2026-07-16