اتصال و API

۰. نصب ادیتور

نصب‌کننده ویندوز را دانلود و اجرا کن. برای نصب به Node، Rust یا ابزار اضافه نیازی نیست (WebView2 روی ویندوز ۱۰/۱۱ موجود است).

اگر لینک دانلود فعال نیست، چند دقیقه بعد دوباره تلاش کن یا از حساب کاربری پیام بده.

۱. اتصال از داخل Codemate

Codemate فقط با اعتبار کار می‌کند؛ کلید API شخصی در ادیتور وجود ندارد. هر درخواست از سرور Codemate عبور می‌کند و آنجا اعتبار و سقف کلید بررسی می‌شود.

1. در ادیتور: Settings → Account.
2. مقدار «Server URL» را برابر آدرس همین سایت بگذار و «تست سرور» را بزن.
3. «ورود / خرید پلن» را بزن؛ مرورگر باز می‌شود، با کد پیامکی وارد شو و دستگاه را تأیید کن.
4. به برنامه برگرد؛ وضعیت «فعال» و اعتبار باقی‌مانده نمایش داده می‌شود.

اگر مرورگر باز نشد، از داشبورد «کد اتصال دستگاه» بگیر و در همان صفحهٔ حساب وارد کن.

۲. کلید 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 هم پشتیبانی می‌شوند.

۳. رفتار اعتبار و خطاها

۴. هزینه چطور محاسبه می‌شود؟

هر پاسخ، توکن ورودی و خروجی واقعی خودش را برمی‌گرداند. سرور هزینه را بر اساس Cache Hit، Cache Miss و خروجی با تعرفهٔ مدل و ساعت مصرف (اوج/غیر اوج) حساب می‌کند و از سقف کلید و اعتبار پلن کم می‌کند. جزئیات هر درخواست (شامل تعرفهٔ اوج یا غیر اوج) در داشبورد ذخیره می‌شود.