صفحه اختصاصی Provider
OpenCode Zen API رایگان
اطلاعات OpenCode Zen: سهمیه رایگان، روش اتصال (متصل مستقیم) و پیش‌نیاز حساب (نیاز به کارت بانکی بین‌المللی) با منبع و تاریخ بررسی.
خلاصه فنی
- نوع سهمیه
- مدل‌های رایگان
- محدودیت نمونه
- وابسته به مدل یا حساب
- سازگار با OpenAI
- بله
- روش اتصال از ایران
- متصل مستقیم
- پیش‌نیاز حساب
- نیاز به کارت بانکی بین‌المللی
- Base URL
https://opencode.ai/zen/v1
قابلیت‌ها
مدل‌های شاخص
deepseek-v4-flash-free، mimo-v2.5-free، north-mini-code-free، nemotron-3-ultra-free، big-pickle، ling-3.0-flash-free، laguna-s-2.1-free، longcat-2.0-free
نکات مهم
پلتفرم OpenCode با ۵ مدل رایگان مدت‌محدود: Big Pickle، DeepSeek V4 Flash Free، MiMo-V2.5 Free، North Mini Code Free، Nemotron 3 Ultra Free. برای دریافت API Key باید اطلاعات صورتحساب اضافه کرد. مدل‌های رایگان ممکن است پس از دوره محدود حذف یا پولی شوند.
دسترسی مستقیم از ایران با کلید API موفق بود.
هدف استفاده و نیت جست‌وجو
OpenCode Zen یک Gateway بهینه‌شده برای coding agentهاست که مدل‌ها و Providerهای انتخاب‌شده را از یک API ارائه می‌کند. بعضی مدل‌ها فقط برای دوره محدود رایگان‌اند و سیاست نگهداری یا استفاده از داده میان مدل‌ها متفاوت است؛ بنابراین مدل رایگان را نباید معادل سرویس دائمی یا مناسب داده محرمانه دانست. دسترسی مستقیم ایران در Evidence فعلی موفق ثبت شده است.
مراحل ثبت‌نام
- در OpenCode Zen وارد شوید و شرایط فعلی حساب، billing و مدل‌های رایگان را در Dashboard بررسی کنید. مدل‌های free و شرایط پرداخت پویا هستند؛ Issue #104 برای refresh دقیق داده Catalog باز است.
- API Key شخصی بسازید و آن را فقط در OPENCODE_ZEN_API_KEY یا secret manager نگهداری کنید. برای هر عضو Team کلید جدا و در صورت امکان سقف مصرف مستقل تعیین کنید.
- پیش از ارسال prompt، بخش Privacy مدل انتخابی را بخوانید. برای مدل‌هایی که داده را برای بهبود جمع‌آوری می‌کنند، اطلاعات شخصی، محرمانه، کلیدها و کد مالکیتی حساس ارسال نکنید.
نمونه اولین درخواست API
curl https://opencode.ai/zen/v1/chat/completions \
-H "Authorization: Bearer $OPENCODE_ZEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-flash-free","messages":[{"role":"user","content":"یک تابع کوتاه پایتون برای مرتب‌سازی بنویس."}]}'مدل نمونه با تست تاریخ‌دار Catalog هماهنگ است، اما مدل‌های رایگان محدودمدت‌اند و ممکن است حذف یا جایگزین شوند. endpoint و مدل فعال را از مستندات Zen و /models دوباره کنترل کنید.
منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16
خطاهای رایج و رفع اشکال
- 401/403 — API Key، Workspace یا دسترسی مدل معتبر نیست
OPENCODE_ZEN_API_KEY و هدر Bearer را بررسی کنید، مطمئن شوید مدل در Workspace فعال است و کلید افشاشده را revoke کنید. Admin می‌تواند دسترسی برخی مدل‌ها را برای Team غیرفعال کرده باشد. منبع رسمی (2026-07-16)
- 402/limit — اعتبار، billing یا سقف ماهانه اجازه ادامه نمی‌دهد
موجودی، auto-reload و monthly limit را در Dashboard کنترل کنید. auto-reload را آگاهانه فعال یا غیرفعال کنید؛ retry خودکار نباید باعث خرید ناخواسته Credit شود. منبع رسمی (2026-07-16)
- 404/model — مدل رایگان منسوخ یا از فهرست حذف شده است
فهرست /models و جدول Deprecated Models را بررسی کنید و شناسه فعال جایگزین را انتخاب کنید. availability مدل‌های free را دائمی فرض نکنید و fallback کنترل‌شده داشته باشید. منبع رسمی (2026-07-16)
چه زمانی این Provider انتخاب مناسبی نیست؟
- زمانی که prompt یا کد حاوی داده شخصی، محرمانه یا مالکیتی است و مدل رایگان انتخابی اجازه جمع‌آوری یا استفاده برای بهبود را دارد.
- زمانی که پروژه به مدل رایگان دائمی، قیمت ثابت یا availability تضمین‌شده نیاز دارد؛ free models و deprecationها پویا هستند.
- زمانی که auto-reload، billing چندارائه‌دهنده‌ای یا routing Gateway برای کنترل مالی و انطباق سازمانی قابل‌قبول نیست.
راهنماهای مرتبط
آخرین بازبینی محتوای این صفحه: 2026-07-16