راهنمای نصب و راه‌اندازی Qwen

گام به گام با تصاویر و کدهای آماده

رایگان زمان نصب: 5-10 دقیقه

مراحل نصب

در 4 مرحله ساده Qwen را راه‌اندازی کنید

1

ساخت حساب در Alibaba Cloud

برای شروع، نیاز به حساب کاربری در پلتفرم رسمی علی‌بابا دارید:

  1. به سایت aliyun.com بروید
  2. روی دکمه «Sign Up» کلیک کنید
  3. اطلاعات خود را وارد و تأیید کنید
  4. ایمیل و شماره موبایل را تأیید کنید
نکته مهم: برای کاربران ایرانی، ممکن است نیاز به استفاده از سرورهای جایگزین یا پراکسی برای ثبت‌نام باشد. در صورت مشکل، از طریق تلگرام با پشتیبانی ما تماس بگیرید.
2

دریافت API Key

پس از ورود به پنل کاربری، مراحل زیر را دنبال کنید:

  1. به بخش Model Studio بروید
  2. مدل Qwen را جستجو کنید
  3. روی دکمه «Activate Now» کلیک کنید
  4. در بخش API Key Management یک کلید جدید ایجاد کنید
  5. کلید را کپی و در جای امنی ذخیره کنید

فرمت API Key:

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

نصب کتابخانه (یکی از روش‌ها را انتخاب کنید)

نصب با Composer
# نصب کتابخانه رسمی
composer require alibabacloud/dashscope

# یا برای پروژه‌های ساده‌تر
composer require guzzlehttp/guzzle
توصیه: برای پروژه‌های تولیدی، حتماً از Composer استفاده کنید تا به‌روزرسانی‌ها به‌صورت خودکار انجام شود.
4

اولین درخواست (Hello World)

hello_qwen.php
<?php
require 'vendor/autoload.php';

use AlibabaCloud\DashScope\DashScope;

// API Key خود را اینجا قرار دهید
DashScope::setApiKey('sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');

$response = DashScope::textGeneration([
    'model' => 'qwen-turbo',
    'input' => [
        'messages' => [
            [
                'role' => 'user',
                'content' => 'سلام! اسمت چیه؟'
            ]
        ]
    ]
]);

// نمایش پاسخ
echo $response['output']['text'];
// خروجی: سلام! من Qwen هستم، هوش مصنوعی علی‌بابا 😊
?>

✅ تست موفق

اگر پاسخ مشابه بالا را دیدید، نصب با موفقیت انجام شده است!

❌ رفع اشکال

خطای "Invalid API Key"؟ کلید را دوباره بررسی کنید یا از پنل علی‌بابا یک کلید جدید ایجاد کنید.

راه‌اندازی پیشرفته

برای پروژه‌های تولیدی

راه‌اندازی روی سرور داخلی ایران

برای کاربران ایرانی که با محدودیت دسترسی به سرورهای خارجی مواجه هستند:

  • استفاده از پروکسی معکوس (Reverse Proxy) برای کاهش تأخیر
  • ذخیره‌سازی موقت پاسخ‌ها (Caching) برای کاهش ترافیک
  • پیاده‌سازی سیستم fallback در صورت قطعی ارتباط

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