پرش به مطلب اصلی

آماده‌سازی و تست اتصال

این مراحل را فقط یک بار انجام می‌دهید. بعد از آن، همان Base URL، کلید و شناسه مدل را می‌توانید در ابزارهای مختلف استفاده کنید.

سرویس هوش مصنوعی چابکان چیست؟​

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

این صفحه نقطه شروع همه راهنماهای این بخش است و برای توسعه‌دهندگان، تیم‌های نرم‌افزاری و مدیرانی نوشته شده که می‌خواهند از چابکان در coding agentها، SDKها، اتوماسیون یا رابط گفت‌وگوی داخلی استفاده کنند.

سه مقدار اصلی اتصال چه هستند؟​

مقدارتعریفمحل دریافت
Base URLآدرس پایه‌ای که ابزار درخواست‌های مدل را به آن می‌فرستداین مستندات؛ معمولاً https://ai.chabokan.net/v1
API Keyکلید محرمانه‌ای که سرویس و سطح مصرف شما را شناسایی می‌کندزبانه «کلیدهای API» در پنل
Model IDشناسه فنی مدل انتخابی، نه نام نمایشی آنزبانه «مدل‌های قابل استفاده» یا /v1/models

اگر یکی از این سه مقدار اشتباه باشد، معمولاً با خطای احراز هویت، مسیر نامعتبر یا مدل پیدا نشد روبه‌رو می‌شوید. به همین دلیل بهتر است پیش از نصب هر ابزار، آزمون cURL همین صفحه را با موفقیت اجرا کنید.

۱. ساخت سرویس هوش مصنوعی​

  1. وارد پنل چابکان شوید.
  2. از منوی محصولات، هوش مصنوعی را باز کنید.
  3. روی ایجاد سرویس هوش مصنوعی کلیک کنید.
  4. یک نام مشخص، مانند تیم برنامه‌نویسی، وارد کنید.
  5. پلن و دوره پرداخت را انتخاب کنید.
  6. کیف پول موردنظر را انتخاب و ساخت سرویس را تأیید کنید.
  7. صبر کنید تا وضعیت سرویس «فعال» شود.

۲. شارژ اعتبار مصرف مدل‌ها​

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

  1. وارد صفحه سرویس شوید.
  2. زبانه اعتبار و شارژ را باز کنید.
  3. مبلغ اعتبار را وارد و کیف پول را انتخاب کنید.
  4. شارژ را تأیید کنید.
  5. مطمئن شوید موجودی اعتبار هوش مصنوعی بیشتر از صفر است.

۳. ساخت API Key​

  1. زبانه کلیدهای API را باز کنید.
  2. روی ایجاد کلید کلیک کنید.
  3. یک نام گویا مانند claude-code-laptop وارد کنید.
  4. در صورت نیاز، تاریخ انقضا و سقف مصرف ماهانه دلاری تعیین کنید.
  5. کلید را بسازید و همان لحظه کپی کنید.

کلید کامل فقط یک بار نمایش داده می‌شود و با sk-chbk- شروع می‌شود. اگر آن را گم کردید، کلید قبلی را لغو و کلید تازه‌ای بسازید.

کلید را محرمانه نگه دارید

کلید را در Git، فایل‌های عمومی، تصویر صفحه، تیکت یا پیام گروهی قرار ندهید. برای هر دستگاه یا محیط یک کلید جدا بسازید تا بتوانید دسترسی همان محیط را مستقل لغو کنید.

۴. انتخاب Model ID​

  1. زبانه مدل‌های قابل استفاده را باز کنید.
  2. مدلی مناسب ابزار و پلن خود انتخاب کنید.
  3. شناسه مدل را دقیقاً کپی کنید؛ برای نمونه: openai/gpt-4o-mini.

نام نمایشی مدل با شناسه آن یکی نیست. ابزارها به شناسه دقیق نیاز دارند. فهرست را نیز می‌توانید با API دریافت کنید:

export CHABOKAN_AI_API_KEY="sk-chbk-کلید-واقعی-شما"

curl --fail-with-body https://ai.chabokan.net/v1/models \
  -H "Authorization: Bearer $CHABOKAN_AI_API_KEY"

۵. آزمایش اتصال پیش از تنظیم ابزار​

شناسه نمونه را در صورت نیاز با مدل انتخاب‌شده خود عوض کنید:

curl --fail-with-body https://ai.chabokan.net/v1/chat/completions \
  -H "Authorization: Bearer $CHABOKAN_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "فقط بنویس: اتصال برقرار است"}
    ]
  }'

اگر در خروجی choices و متن پاسخ را دیدید، سرویس، اعتبار، کلید و مدل آماده‌اند. در غیر این صورت به راهنمای عیب‌یابی بروید.

۶. نگهداری امن متغیر در ترمینال​

دستور export فقط تا زمان بسته‌شدن همان ترمینال فعال است و برای آزمایش امن‌تر است:

export CHABOKAN_AI_API_KEY="sk-chbk-کلید-واقعی-شما"

در PowerShell ویندوز:

$env:CHABOKAN_AI_API_KEY = "sk-chbk-کلید-واقعی-شما"

برای استفاده دائمی، از secret manager سیستم یا ابزار استفاده کنید. اگر ناچار به فایل .env هستید، آن را به .gitignore اضافه کنید.