صفحه اختصاصی Provider

GitHub Models API رایگان

اطلاعات GitHub Models: سهمیه رایگان، روش اتصال (متصل مستقیم) و پیش‌نیاز حساب (بدون نیاز به کارت بانکی بین‌المللی) با منبع و تاریخ بررسی.

متصل مستقیمآخرین بررسی: 2026-07-20

خلاصه فنی

نوع سهمیه: سهمیه دائمی
محدودیت نمونه: 15 RPM · 150 RPD
سازگار با OpenAI: بله
روش اتصال از ایران: متصل مستقیم
پیش‌نیاز حساب: بدون نیاز به کارت بانکی بین‌المللی
Base URL: https://models.github.ai/inference

قابلیت‌ها

مدل‌های شاخص

فهرست مدل‌ها پویا است؛ منبع رسمی را بررسی کنید.

نکات مهم

استفادهٔ رایگان API در Public Preview است؛ بعضی مدل‌ها محدودیت اختصاصی پایین‌تری دارند.

برای API به توکن GitHub با مجوز models:read نیاز است.

درخواست زنده با curl از شبکهٔ ثابت ایران موفق بود. تفاوت رفتار Node.js fetch و curl فقط در شبکهٔ آزمون مشاهده شد و به‌عنوان محدودیت عمومی سرویس تعمیم داده نمی‌شود.

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

GitHub Models برای نمونه‌سازی، مقایسه مدل‌ها و اجرای آزمایش‌های کوچک در محیط GitHub یا GitHub Actions مناسب است. این راهنما روی ساخت توکن حداقلی، ارسال درخواست سازگار با OpenAI و مدیریت محدودیت‌های Public Preview تمرکز دارد؛ دسترسی موفق ثبت‌شده از ایران یک Evidence تاریخ‌دار است و تضمین دائمی محسوب نمی‌شود.

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

با حساب GitHub وارد Marketplace مدل‌ها شوید و مدل موردنظر را از کاتالوگ رسمی انتخاب کنید؛ شناسه مدل باید دقیقاً مطابق نمونه کد همان صفحه باشد.
برای اجرای محلی یک Personal Access Token با حداقل مجوز لازم برای GitHub Models بسازید و آن را در متغیر محیطی GITHUB_MODELS_TOKEN نگهداری کنید؛ برای GitHub Actions نیز permissions مربوط به models را فقط در سطح موردنیاز فعال کنید.
ابتدا یک درخواست کوچک اجرا کنید و سپس محدودیت مدل، تعداد درخواست روزانه و هم‌زمانی را از مستندات و metadata کاتالوگ کنترل کنید؛ Public Preview برای بار تولیدی تضمین‌شده طراحی نشده است.

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

curl -L -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer $GITHUB_MODELS_TOKEN" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  -H "Content-Type: application/json" \
  https://models.github.ai/inference/chat/completions \
  -d '{"model":"openai/gpt-4.1-mini","messages":[{"role":"user","content":"سلام! کوتاه پاسخ بده."}]}'

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

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

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

401 — توکن نامعتبر یا منقضی
مقدار GITHUB_MODELS_TOKEN، تاریخ انقضا و هدر Authorization را بررسی کنید؛ توکن را در خروجی CI یا گزارش عمومی چاپ نکنید. منبع رسمی (2026-07-15)
403 — مجوز Models کافی نیست
Scope یا permission مربوط به GitHub Models را برای نوع توکن یا workflow فعال کنید و اصل کمترین دسترسی را حفظ کنید؛ مجوزهای نامرتبط اضافه نکنید. منبع رسمی (2026-07-15)
404 — شناسه مدل پیدا نشد
مالک و نام کامل مدل را از Marketplace کپی کنید و بررسی کنید مدل هنوز در کاتالوگ و برای نوع حساب شما قابل استفاده باشد. منبع رسمی (2026-07-15)
429 — سقف Public Preview رد شد
درخواست‌ها را صف‌بندی کنید، backoff و jitter اضافه کنید و محدودیت کلاس مدل و حساب را بررسی کنید؛ retry فوری و هم‌زمان فشار را بیشتر می‌کند. منبع رسمی (2026-07-15)

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

زمانی که سرویس تولیدی به SLA، ظرفیت رزروشده یا ثبات بلندمدت شناسه مدل نیاز دارد؛ API رایگان GitHub Models در Public Preview است.
زمانی که پروژه نباید به حساب GitHub، PAT یا permission مخصوص workflow وابسته باشد.
زمانی که تعداد درخواست یا context موردنیاز از محدودیت کلاس مدل و حساب رایگان بیشتر است.

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

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

منابع بررسی

APIهای مرتبط

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