Zed با هوش مصنوعی FluxCDN
Zed ارائهدهندهٔ سازگار با OpenAI را مستقیم میپذیرد. ایجنت Zed، دستیار درونخطی، پیامهای commit و خلاصهٔ گفتوگوها از آن استفاده میکنند. کلید در keychain سیستم میماند.
- مجوز:
- GPL-3.0 (بخشهایی Apache-2.0)
- سیستمعاملها:
- macOS، Linux، Windows
- آدرس (سازگار با OpenAI):
https://ai.fluxcdn.cloud/api/v1
پیش از شروع
- یک کلید API بسازید. در صفحهٔ کلیدهای API دکمهٔ «ساخت کلید» را بزنید و کلید را همان لحظه کپی کنید؛ با
flux_live_شروع میشود و دوباره کامل نشان داده نمیشود. - برای ایجنتها کلید جدا بسازید و با دکمهٔ «سقفها» برایش سقف هزینهٔ روزانه یا ماهانه بگذارید. ایجنتها خودشان پشت هم درخواست میفرستند؛ سقف جلوی هزینهٔ پیشبینینشده را میگیرد.
- کمی اعتبار در حساب داشته باشید (صورتحساب).
- در نمونهها بهجای
flux_live_YOUR_KEYکلید خودتان را بگذارید.
راهاندازی
گام 1: یک ترکیب مدل انتخاب کنید و تنظیمها را بنویسید
Zed → Settings → Open Settings File و این بخش را اضافه کنید. یا از Settings → AI → LLM Providers → Add Provider همین مقدارها را بدهید.
max_tokensدر Zed یعنی پنجرهٔ متن.قیمت هر میلیون توکن. قیمتهای طرح رایگان، به تومان با نرخ امروز. مسیریابها (
router/autoو مانند آن) برای ایجنتها پیشنهاد نمیشوند: ایجنت به مدلی نیاز دارد که حتماً ابزار را پشتیبانی کند.Zed: settings.json{ "language_models": { "openai_compatible": { "fluxcdn": { "api_url": "https://ai.fluxcdn.cloud/api/v1", "available_models": [ { "name": "anthropic/claude-sonnet-5.5", "display_name": "Claude Sonnet 5.5 (FluxCDN)", "max_tokens": 1000000, "max_output_tokens": 32000, "capabilities": { "tools": true, "images": true, "parallel_tool_calls": false, "prompt_cache_key": false } } ] } } } }گام 2: کلید را بدهید
کلید را در صفحهٔ ارائهدهنده وارد کنید، یا در متغیر
FLUXCDN_API_KEYبگذارید. کلید را در settings.json ننویسید.~/.zshrc · ~/.bashrcexport FLUXCDN_API_KEY="flux_live_YOUR_KEY"
بررسی کنید که کار میکند
گام 1: از ایجنت بخواهید فایلی را بخواند
پنل Agent را باز کنید، مدل FluxCDN را از فهرست بردارید و بخواهید یک فایل را بخواند. اگر ابزار صدا زده شد، درست کار میکند.
رفع مشکل
- مدل در فهرست مدلهای Zed نیست
- Zed فقط مدلهایی را نشان میدهد که در
available_modelsنام بردهاید. برای هر مدل یک بلوک اضافه کنید و شناسه را دقیقاً از صفحهٔ مدلها کپی کنید. - خطای 401 یا
invalid_api_key - کلید کامل کپی نشده، باطل شده یا جای دیگری گذاشته شده. کلید با
flux_live_شروع میشود و فاصلهٔ اضافه ندارد. اگر ابزار کلید را از متغیر محیطی میخواند، پس از تنظیم آن یک ترمینال یا پنجرهٔ تازه باز کنید. - خطای 402،
insufficient_credit(در Codex:insufficient_quota) با اینکه اعتبار دارید - پیش از هر درخواست، بیشترین هزینهای که آن درخواست ممکن است داشته باشد از اعتبارتان کنار گذاشته میشود. وقتی پاسخ تمام شد فقط هزینهٔ واقعی برداشته میشود و بقیه برمیگردد. ابزاری که برای هر درخواست خروجی خیلی بلندی میخواهد، مبلغ بزرگی کنار میگذارد. سقف خروجی ابزار را کمتر کنید (مثلاً 32000 توکن) یا اعتبار اضافه کنید.
- خطای 404 یا
model_not_found - شناسهٔ مدل باید دقیقاً همان باشد که در صفحهٔ مدلها آمده، با پیشوند سازنده:
anthropic/claude-sonnet-5.5، نهclaude-sonnet-5.5. حروف کوچک و نقطهها مهماند. شناسه را کپی کنید، تایپ نکنید. - خطای 404 که از مدل حرفی نمیزند
- آدرس پایه درست نیست. بیشتر ابزارها
https://ai.fluxcdn.cloud/api/v1را میخواهند و خودشان بقیه را اضافه میکنند؛/chat/completionsرا دو بار ننویسید و/v1را جا نیندازید. جدول کدام آدرس را ببینید. - ایجنت ابزاری صدا نمیزند یا مدل در فهرست ایجنت نیست
- مدلی انتخاب کنید که ابزار (tools) را پشتیبانی کند؛ در صفحهٔ مدلها برچسب Tools دارد. در بعضی ابزارها باید این قابلیت را برای مدل روشن کنید (گامهای بالا). مسیریابها برای ایجنتها پیشنهاد نمیشوند.
- خطای 429:
rate_limit_exceededیاbudget_exceeded - یا تعداد درخواست در دقیقه از سقف گذشته (کمی صبر کنید؛ بیشتر ابزارها خودشان دوباره میفرستند)، یا هزینهٔ امروز یا این ماهِ همین کلید به سقفش رسیده. سقف را در کلیدهای API با دکمهٔ «سقفها» ببینید.
- خطای 502، 503، 504 یا 529
- سرویس سازندهٔ مدل لحظهای در دسترس نبوده. دوباره بفرستید؛ بیشتر ابزارها خودشان این کار را میکنند. درخواستی که پیش از پاسخ شکست بخورد هزینهای ندارد. اگر طول کشید، موقتاً مدل دیگری انتخاب کنید.
محدودیتها
- پیشبینی ویرایش (edit predictions، تکمیل Tab) از FluxCDN استفاده نمیکند.

