راهنمای داشبورد

استفاده از کنسول QCode.cc: آدرس دسترسی API، ساخت و کپی کلیدهای API، آمار مصرف، شارژ حساب، خرید پلن، کلیدهای فرعی تیمی و توکن دسترسی Open API

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

در qcode.cc وارد شوید و کنسول را در qcode.cc/dashboard باز کنید. کنسول خود را در یک خط خلاصه می‌کند — «کلیدهای API، شارژ حساب و مصرف خود را مدیریت کنید» — و یک صفحه واحد است: کلیدها، موجودی، پلن‌ها، مصرف، پاداش‌های معرفی و پشتیبانی همگی در همان‌جا قرار دارند.

مطمئن نیستید کلید QCode چه تفاوتی با اشتراک Claude / ChatGPT دارد؟ ابتدا اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode را بخوانید. خارج از سرزمین اصلی چین هستید؟ با QCode برای کاربران خارج از سرزمین اصلی چین شروع کنید.

کنسول شامل چه چیزهایی است¶

آدرس دسترسی API¶

عنوان این بلوک آدرس دسترسی API است و هر ردیف دکمه کپی مخصوص خود را دارد. اینکه کدام ردیف به‌عنوان پیشنهادی برجسته شود به زبان کنسولی بستگی دارد که با آن وارد شده‌اید:

• رابط چینی — ردیف https://asia.qcode.cc/api به‌عنوان ردیف پیشنهادی برجسته می‌شود و زیر آن این یادداشت نمایش داده می‌شود: «کاربران سرزمین اصلی چین باید از آدرس شتاب‌یافته استفاده کنند؛ دیگران از آدرس جهانی استفاده کنند. عملکرد هر دو یکسان است».

• هر رابط غیرچینی (در حال حاضر انگلیسی، ژاپنی، روسی) — ردیف https://api.qcode.cc برجسته می‌شود و ردیف‌های زیر آن با برچسب پشتیبان مشخص می‌شوند (ایالات متحده: https://us.qcode.cc/api، آسیا: https://asia.qcode.cc/api).

آدرسی که کپی می‌کنید هنوز باید پیشوند مسیر درست را برای ابزاری که استفاده می‌کنید داشته باشد — به نقاط پایانی و مسیرهای API مراجعه کنید. برای Claude Code این جفت به این شکل است:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"

کلیدهای API: ایجاد، مشاهده و کپی¶

API Key Management همان بخشی است که دکمه Create Key & Activate Service در آن قرار دارد. اگر هنوز کلیدی ندارید، حالت خالی ترتیب عملیات را شرح می‌دهد: Top Up Balance → Buy a Plan → Start Using.

1. در qcode.cc/recharge شارژ حساب کنید (به نمای کلی روش‌های پرداخت مراجعه کنید).
2. در qcode.cc/subscribe یک پلن انتخاب کنید — یا Recommended Plans یا Custom Configuration — و تأیید کنید. خرید موفق این پیام را نشان می‌دهد: «اشتراک فعال شد — کلید API شما ایجاد شده و آماده استفاده است» و کلید را همراه با دکمه کپی و پیوند Go to Dashboard نمایش می‌دهد.
3. پس از بازگشت به کنسول، مقدار کلید به‌طور پیش‌فرض نمایش داده نمی‌شود: ردیف تا زمانی که دکمه چشم را برای آشکارسازی فشار ندهید در حال بارگذاری… نشان می‌دهد و سپس Copy. اگر پیش از بارگذاری مقدار کپی کنید، کنسول به شما اطلاع می‌دهد و رشته خالی کپی نمی‌شود.

موارد دیگر در همان بخش:

• کلیدی که تازه سفارش داده شده می‌تواند «کلید API در حال فعال‌سازی است؛ در اسرع وقت آن را پردازش می‌کنیم» را همراه با پیوندی به پشتیبانی آنلاین نشان دهد.
• کلیدی که از قبل دارید می‌تواند دکمه Renew را نشان دهد (تمدید سریعی که از موجودی شما محاسبه می‌شود).

• کلیدهایی که به پایان رسیده‌اند زیر فهرست جمع‌شده Expired keys نمایش داده می‌شوند و با کلید منقضی شده یا غیرفعال شده مشخص می‌شوند.

• حساب‌هایی که بسته‌های پرداخت به‌ازای مصرف خریداری کرده‌اند یک کارت اضافی Pay-as-you-go Key دریافت می‌کنند (فقط برای چنین حساب‌هایی نمایش داده می‌شود): وضعیت (Active / Quota used up / Expired)، سهمیه باقی‌مانده، تاریخ انقضا همراه با روزهای باقی‌مانده، تعداد درخواست‌های هم‌زمان، و دکمه‌های Buy more و Upgrade to a personal plan. هر حساب فقط یک کلید بسته دارد و تمدیدها روی آن انباشته می‌شوند؛ خرید دوباره پس از انقضا همان کلید را بازیابی می‌کند.

• هر کارت سه کلاینتی را که یک کلید به آن‌ها سرویس می‌دهد پیوند می‌دهد: Claude، Codex و Gemini (QCode در حال حاضر مدل‌های Gemini را ارائه نمی‌دهد).

دستورات راه‌اندازی یک‌کلیکی¶

هر کارت کلید فعال یک بخش One-Click Setup (Recommended) دارد با تب macOS / Linux و Windows، یک خط دستور برای Claude Code و یک خط برای Codex، که هر کدام دکمه Copy مخصوص خود را دارند:

curl -fsSL https://qcode.cc/install/claude-code.sh | bash
curl -fsSL https://qcode.cc/install/codex.sh | bash

راهنمای کنسول زیر این بخش: «وقتی اسکریپت کلید را درخواست کرد، کلید خود را در بالا جای‌گذاری کنید.» در تب Windows، دستورات معادل‌های irm … | iex هستند و یک بخش جمع‌شده در زیر آن یک دستور تک‌خطی CMD و یک راه‌انداز قابل دانلود برای ماشین‌هایی اضافه می‌کند که irm در آن‌ها در دسترس نیست یا توسط خط‌مشی اجرا مسدود شده است. راهنمای کامل، از جمله نحوه اجبار زبان رابط اسکریپت، در اسکریپت راه‌اندازی یک‌کلیکی آمده است.

آمار مصرف¶

بلوک آمار مصرف به کلید فعال شما گره خورده است («سهمیه مصرف برای کلید فعال فعلی») و می‌تواند به‌صورت زمان‌بندی‌شده (خاموش / 5 / 10 / 30 / 60 دقیقه) یا به‌صورت دستی با بازخوانی به‌روزرسانی شود.

با آن‌که هرگز claude-sonnet-5 را انتخاب نکرده‌اید، آن را در فراخوانی‌های مدل امروز می‌بینید؟ به احتمال زیاد این‌ها درخواست‌های بررسی ایمنی هستند که Claude Code در حالت دسترسی auto ارسال می‌کند؛ چرا Claude Sonnet 5 در آمار مصرف شما ظاهر می‌شود را ببینید.

سلب مسئولیت خود پنل: «داده‌های نمایش‌داده‌شده در اینجا ممکن است کمی متفاوت باشد؛ حدود واقعی بر اساس پاسخ‌های Claude Code است.» برای یک عدد تقریبی به‌ازای هر نشست از /cost در Claude Code استفاده کنید و برای نحوه محاسبه هزینه شرح صورت‌حساب را ببینید.

شارژ حساب، پلن‌ها، بسته‌های تقویتی و ارتقا¶

• موجودی به تفکیک ارز است. «موجودی CNY و USD جداگانه است. مبلغ شارژ به موجودی ارز متناظر اضافه می‌شود.» نوار کاربر هر دو عدد را کنار هم نشان می‌دهد.
• حدود شارژ حساب که در صفحه شارژ نمایش داده می‌شود: حداقل ¥30 برای CNY، حداقل $5 و حداکثر $2,000 برای USD، به‌همراه سقف‌های هر روش پرداخت که صفحه هنگام رسیدن به آن‌ها توضیح می‌دهد.
• بازگشت پس از شارژ حساب: بنر کنسول این متن را نشان می‌دهد: «موجودی دریافت شد — اکنون می‌توانید یک پلن را فعال کنید.» همراه با دکمه انتخاب پلن. باقی‌مانده از بین نمی‌رود — «هر موجودی‌ای که پس از شارژ حساب باقی بماند هدر نمی‌رود: بعداً آن را برای ارتقا یا یک بسته تقویتی استفاده کنید.»
• خرید چندماهه: قیمت ماهانه کمتر با خرید از 3 ماه (−10% / −20% / −25%)؛ کنسول می‌نویسد: «از 3 ماه، ماهانه 10% صرفه‌جویی کنید؛ 20% در 6 ماه و 25% در 12 — 12 ماه به قیمت 9 ماه. یک‌بار پرداخت، بدون تمدید خودکار.»
• بسته‌های تقویتی (Self-service Booster Pack) را می‌توانید با موجودی از کنسول بخرید و سهمیه خود را فوراً افزایش دهید؛ آن‌ها ساعت 2 بامداد به وقت پکن (UTC+8) بازنشانی می‌شوند.
• بسته‌های پرداخت به‌ازای مصرف: تمدیدها روی همان کلید بسته انباشته می‌شوند و تاریخ انقضا، دیرترِ تاریخ انقضای فعلی و امروز + تعداد روزهای بسته است؛ اگر بعداً پلن شخصی می‌خواهید، فقط آن را بخرید و بسته تا زمان انقضا به کار خود ادامه می‌دهد. بسته‌ها غیرقابل بازپرداخت هستند؛ قواعد در بسته‌های پرداخت به‌ازای مصرف آمده است.
• ارتقاها دکمه‌ای در کنسول نیستند: ابتدا پلن بالاتر را بخرید، سپس به hi@qcode.cc ایمیل بزنید تا پلن قدیمی بسته شود و ارزش استفاده‌نشده آن به موجودی شما برگردد.

کلیدهای فرعی و قابلیت‌های تیمی¶

کنسول شخصی یک کلید اصلی به‌ازای هر پلن را مدیریت می‌کند (و یک کلید بسته به‌ازای هر حساب کاربری برای بسته‌های پرداخت به‌ازای مصرف) — هیچ صفحه خودخدمتی برای کلید فرعی در آن وجود ندارد. کلیدهای فرعی بخشی از محصولات تیمی هستند:

• صفحه پلن تیمی یک مرکز مدیریت کلیدهای فرعی API را با «پیکربندی و مدیریت دقیق برای هر عضو تیم» توصیف می‌کند و جدول مقایسه پلن‌ها کلیدهای فرعی نامحدود، هر یک با سهمیه اختصاصی خود را فهرست می‌کند. این نسخه همچنین پشتیبانی از انتقال بانکی و توافق‌نامه‌های خدمات سفارشی را فهرست می‌کند. مراحل: راهنمای پلن تیمی.
• در صفحه اشتراک، کارت تیمی «مدیریت انعطاف‌پذیر سهمیه و کلید فرعی» را تبلیغ می‌کند و به hi@qcode.cc ارجاع می‌دهد.
• خود کنسول تنها معرفی تیمی را ارائه می‌دهد — یک گزینه تیمی / سازمانی در پنجره خوش‌آمدگویی و یک پنجره قابلیت‌های تیمی برای پلن تیمی («مدیریت چند حساب کاربری برای همکاری تیمی»، «خدمات سفارشی…»، «پشتیبانی فنی اختصاصی…»).
• نمایندگان فروش یک داشبورد شرکای جداگانه با امکان صدور کلید فرعی دریافت می‌کنند که در راهنمای Open API شرکا پوشش داده شده است.

توکن دسترسی Open API¶

کارت Open API می‌گوید: «از یک توکن دسترسی برای استعلام برنامه‌ای تاریخ انقضا و مصرف روزانه کلیدهای API خود استفاده کنید.» گزینه مدیریت توکن (Manage Token) صفحه /dashboard/openapi-token را باز می‌کند، جایی که می‌توانید توکن را تولید، بازنشانی یا باطل کنید:

curl -H "Authorization: Bearer qot_..." \
  https://qcode.cc/api/v1/openapi/keys

• دو نقطه پایانی فقط‌خواندنی در آن صفحه فهرست شده است: یکی برای تاریخ انقضا و مصرف همه کلیدهای فعال شما، و یکی برای خلاصه مصرف در سطح حساب کاربری.
• توکن فقط یک بار نمایش داده می‌شود: «توکن جدید شما (فقط یک بار نمایش داده می‌شود) — همین حالا آن را کپی کنید»، و «ما فقط یک هش ذخیره می‌کنیم — اگر آن را گم کنید، بازنشانی کنید تا توکن جدیدی دریافت کنید (توکن قدیمی بلافاصله از کار می‌افتد).»
• بازنشانی و باطل‌سازی هر دو درخواست تأیید می‌کنند، و باطل‌سازی دسترسی به Open API را تا زمانی که توکن جدیدی تولید کنید غیرفعال می‌کند.
• این توکن شخصی با qot_ شروع می‌شود. این توکن نماینده فروش نیست: شرکا یک توکن rsk_ در داشبورد شرکا زیر «Open API / Access Token» دریافت می‌کنند و آن توکن به Partner Open API (موجودی، مصرف، مدیریت کلید فرعی) مجوز می‌دهد. این دو قابل‌تبادل نیستند — به راهنمای Open API شرکا مراجعه کنید.

پرسش‌های پشتیبانی و سفارش¶

• خط پشتیبانی کنسول: «روزهای هفته 10:00 - 21:00 (UTC+8) پاسخ آنلاین»، با پیام‌های خارج از ساعت کاری «به‌صورت متناوب بررسی می‌شود، پاسخ‌ها ممکن است با تأخیر همراه باشد»، و «ایمیل در هر زمان در دسترس است: hi@qcode.cc».
• پشتیبانی زنده همان دکمه تماس با ما در گوشه پایین-راست است (Telegram یا ایمیل).
• درخواست پردازش فوری دلیل انتظار را توضیح می‌دهد: حساب‌های تازه‌تأمین‌شده در ساعات کاری یک تا دو ساعت زمان می‌برند تا اعمال و پیکربندی شوند.
• لینک‌های سریع همچنین شامل راهنمای مصرف (پایگاه دانش) و کدهای خطای رایج است؛ برای علائم و راه‌حل‌ها به راهنمای عیب‌یابی و مرجع کدهای خطا مراجعه کنید.

صفحات مرتبط¶

• مرور روش‌های پرداخت — کدام روش‌ها برای شارژ حساب پذیرفته می‌شوند
• توضیحات صورت‌حساب — چگونه مصرف به مبلغ تبدیل می‌شود
• بسته‌های پرداخت به‌ازای مصرف — قیمت بسته‌ها، تمدید و انقضا
• چگونه یک پلن انتخاب کنیم — چهار گزینه در کنار هم
• نقاط پایانی و مسیرهای API — آدرس به‌همراه پیشوند مسیر
• متغیرهای محیطی — کجا قرار گیرند
• اسکریپت نصب یک‌کلیکی — دستورهای کنسول چه کاری انجام می‌دهند
• اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode
• راهنمای پلن تیمی — کلیدهای فرعی و انتقال سازمانی
• راهنمای Open API شرکا
• پرسش‌های متداول

سازمانی ←