صفحه اختصاصی Provider
Cloudflare Workers AI API رایگان
اطلاعات Cloudflare Workers AI: سهمیه رایگان، روش اتصال (متصل مستقیم) و پیش‌نیاز حساب (بدون نیاز به کارت بانکی بین‌المللی) با منبع و تاریخ بررسی.
خلاصه فنی
- نوع سهمیه
- سهمیه دائمی
- محدودیت نمونه
- وابسته به مدل یا حساب
- سازگار با OpenAI
- بله
- روش اتصال از ایران
- متصل مستقیم
- پیش‌نیاز حساب
- بدون نیاز به کارت بانکی بین‌المللی
- Base URL
https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/v1
قابلیت‌ها
مدل‌های شاخص
@cf/meta/llama-3.2-3b-instruct
نکات مهم
۱۰٬۰۰۰ Neuron در روز رایگان است؛ برای مصرف بیشتر باید Workers Paid فعال شود.
API پایه شامل account_id است و برای نمایش در URL به صورت placeholder نگهداری شده است.
⚠️ مدل پیش‌فرض از @cf/meta/llama-3.1-8b-instruct به @cf/meta/llama-3.2-3b-instruct تغییر یافت.
هدف استفاده و نیت جست‌وجو
Cloudflare Workers AI برای پروژه‌ای مناسب است که می‌خواهد چت، Embedding یا خروجی ساخت‌یافته را با API رسمی Cloudflare و endpoint سازگار با OpenAI اجرا کند. این صفحه مسیر ساخت Token کم‌اختیار، استفاده از Account ID، ارسال اولین درخواست و مدیریت سهمیه روزانه Neuron را توضیح می‌دهد؛ وضعیت ایران و اعداد سهمیه همچنان از Catalog تاریخ‌دار پروژه خوانده می‌شوند.
مراحل ثبت‌نام
- یک حساب Cloudflare بسازید و از داشبورد Workers AI گزینه Use REST API را باز کنید؛ Account ID را دقیقاً از همان صفحه بردارید و آن را به‌عنوان مقدار عمومی تنظیمات، نه Secret، نگهداری کنید.
- با الگوی رسمی Workers AI یک API Token دارای مجوزهای ضروری Workers AI Read و Workers AI Edit بسازید. مقدار Token را فقط یک‌بار کپی کنید و در متغیر محیطی CLOUDFLARE_API_TOKEN قرار دهید؛ آن را در frontend، Git یا خروجی CI چاپ نکنید.
- مدل فعال را از Catalog رسمی مدل‌ها انتخاب کنید و پیش از توسعه اصلی یک درخواست کوتاه با Account ID و Token همان حساب بفرستید. مصرف واقعی به مدل و تعداد توکن وابسته است و داشبورد Neuron مرجع نهایی مصرف روزانه است.
نمونه اولین درخواست API
curl "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions" \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model":"@cf/meta/llama-3.2-3b-instruct","messages":[{"role":"user","content":"سلام! کوتاه پاسخ بده."}]}'Account ID و Token از متغیر محیطی خوانده می‌شوند. مدل نمونه با Evidence فعلی Catalog هماهنگ است؛ پیش از استفاده طولانی، فعال‌بودن مدل را در فهرست رسمی مدل‌ها دوباره کنترل کنید.
منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16
خطاهای رایج و رفع اشکال
- 401/403 — Token نامعتبر یا فاقد مجوز Workers AI
وجود هدر Bearer، معتبر بودن CLOUDFLARE_API_TOKEN و مجوزهای Workers AI Read/Edit را بررسی کنید. Token را rotate کنید، اما مقدار قبلی یا جدید را در گزارش خطا منتشر نکنید. منبع رسمی (2026-07-16)
- 400/404 — Account ID، endpoint یا مدل نادرست
Account ID را از داشبورد همان حساب بردارید، مسیر /ai/v1/chat/completions را حفظ کنید و شناسه مدل را با Catalog رسمی Workers AI تطبیق دهید. مدل منسوخ را با مدل فعال جایگزین کنید. منبع رسمی (2026-07-16)
- 429/quota — پایان سهمیه یا عبور از محدودیت
Neuron مصرفی را در داشبورد کنترل کنید، درخواست‌ها را کوچک‌تر و زمان‌بندی کنید و retry را فقط با backoff انجام دهید. تخصیص رایگان روزانه در ۰۰:۰۰ UTC reset می‌شود و مصرف بیشتر به Workers Paid نیاز دارد. منبع رسمی (2026-07-16)
چه زمانی این Provider انتخاب مناسبی نیست؟
- زمانی که پروژه به سهمیه‌ای بر حسب تعداد ثابت درخواست یا توکن نیاز دارد؛ Cloudflare مصرف را با Neuron و هزینه مدل‌محور اندازه‌گیری می‌کند.
- زمانی که مدیریت Account ID، Tokenهای Cloudflare و مجوزهای حساب برای تیم قابل‌قبول نیست یا پروژه باید بدون حساب Cloudflare اجرا شود.
- زمانی که استقرار تولیدی به یک مدل ثابت بدون چرخه deprecation وابسته است؛ فهرست مدل‌ها و اعلان‌های منسوخ‌شدن باید دوره‌ای پایش شوند.
راهنماهای مرتبط
آخرین بازبینی محتوای این صفحه: 2026-07-16