اتصال و API
سرور Codemate Cloud هم با ادیتور کار می‌کند و هم با هر کلاینت سازگار با OpenAI.
آدرس پایه: —
۰. نصب ادیتور
نصب‌کننده ویندوز را دانلود و اجرا کن. برای نصب به Node، Rust یا ابزار اضافه نیازی نیست (WebView2 روی ویندوز ۱۰/۱۱ موجود است).
اگر لینک دانلود فعال نیست، سرور بدون فایل نصب اجرا شده؛ DOWNLOADS_DIR را
به پوشه‌ی نصب‌کننده اشاره بده.
۱. اتصال از داخل Codemate
Codemate فقط با اشتراک کار می‌کند؛ کلید API شخصی در ادیتور وجود ندارد. هر درخواست از سرور Codemate عبور می‌کند و آنجا اعتبار و سقف کلید بررسی می‌شود.
- در ادیتور: Settings → Account.
- مقدار «Server URL» را برابر آدرس همین سایت بگذار و «تست سرور» را بزن.
- «ورود / خرید اشتراک» را بزن؛ مرورگر باز می‌شود، با کد پیامکی وارد شو و دستگاه را تأیید کن.
- به برنامه برگرد؛ وضعیت «فعال» و اعتبار باقی‌مانده نمایش داده می‌شود.
اگر مرورگر باز نشد، از داشبورد «کد اتصال دستگاه» بگیر و در همان صفحهٔ حساب وارد کن.
۲. کلید API و درخواست مستقیم
در داشبورد → کلیدها، یک کلید با سقف دلاری بساز. کلید فقط یک‌بار نمایش داده می‌شود.
# chat completions (streaming) curl https://your-domain.com/codemate/v1/chat/completions \ -H "Authorization: Bearer cm_live_..." \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-flash", "messages": [{"role": "user", "content": "سلام!"}], "stream": true }'
پاسخ‌ها با همان قالب OpenAI برمی‌گردند؛ ابزارها (tool calling)،
reasoning_effort و thinking هم پشتیبانی می‌شوند.
۳. رفتار اعتبار و خطاها
| کد | معنا | کاری که باید بکنی |
|---|---|---|
| 401 | توکن نامعتبر یا حذف‌شده | از تنظیمات حساب دوباره وارد شو. |
| 402 / insufficient_credit | اعتبار تمام شده | پلن را تمدید یا کیف پول را شارژ کن؛ پاسخ شامل purchase_url است. |
| 402 / key_limit_reached | سقف دلاری همین کلید پر شده | سقف را از داشبورد بالا ببر یا کلید جدید بساز. |
| 403 / device_mismatch | توکن روی دستگاه دیگری استفاده شده | از داخل همان دستگاه متصل شو. |
| 429 | درخواست بیش از حد | کمی صبر کن و دوباره بفرست. |
۴. مسیرهای داخلی ادیتور
| مسیر | کاربرد |
|---|---|
| /codemate/v1/ping | تست اتصال سرور |
| /codemate/v1/connect/start | شروع اتصال دستگاه |
| /codemate/v1/connect/poll | دریافت توکن پس از تأیید |
| /codemate/v1/activate | ورود با کد اتصال |
| /codemate/v1/heartbeat | به‌روزرسانی اعتبار و اعتبارسنجی |
| /codemate/v1/preflight | بررسی اعتبار و سقف پیش از ارسال پرامپت |
| /codemate/v1/chat/completions | پروکسی مدل با کسر اعتبار |
| /codemate/v1/beta/completions | تکمیل خودکار (FIM) |
مسیرهای /wp-json/codemate/v1/* هم به همین سرویس‌دهنده وصل‌اند تا ادیتورهای قدیمی‌تر کار کنند.
۵. هزینه چطور محاسبه می‌شود؟
هر پاسخ، توکن ورودی و خروجی واقعی خودش را برمی‌گرداند. سرور همان لحظه هزینه را با قیمت دیپ‌سیک حساب می‌کند (پیش‌فرض: ورودی — و خروجی — دلار برای هر یک میلیون توکن) و از سقف کلید و اعتبار پلن کم می‌کند. جزئیات هر درخواست در داشبورد ذخیره می‌شود.