API לבינה מלאכותית ב-Qwen Code ב-2026: מפתח, חיבור וחישוב השימוש

מישהו מתקין את Qwen Code, מפעיל אותו במסוף, ובבקשה הראשונה הוא מבקש מפתח. ואז מתחיל החיפוש: אנשים מקלידים “buy api key for qwen code” ומגיעים לדפים שבהם מוכרים להם מינוי או גישה מוכנה של מישהו אחר. הנה מהו המפתח, היכן מקבלים אותו וכמה הוא עולה, צעד אחר צעד.

הנקודה העיקרית כבר בהתחלה: אף אחד לא מוכר מפתח API כמוצר נפרד באריזה. זהו מחרוזת גישה שמנפיקים בעצמכם בחשבון אצל ספק המודלים, והנפקתה בחינם. תצטרכו כסף בהמשך, כשתטעינו את היתרה; בשלב הזה חלים תנאי הספק. בהמשך: היכן מקבלים מפתח, איך מחברים אותו ל-Qwen Code ומה עולה השימוש בו.

איך מפתח API מחבר את Qwen Code למודל בינה מלאכותית?#

Qwen Code הוא סוכן AI בקוד פתוח שפועל במסוף וכותב קוד למשימות שלכם. הוא חינמי, מותקן באמצעות npm, ואין בו רשת עצבית משלו. המודל עושה את כל העבודה החכמה, ופועל בשרתים של הספק.

Qwen Code זקוק לאישור מעבר כדי להגיע למודל. האישור הזה הוא מפתח API — מחרוזת ארוכה כמו סיסמה, שהספק מנפיק לכם אישית. כשהסוכן שולח בקשה, הוא מצרף את המפתח; הספק משתמש בו כדי לזהות למי שייכת הבקשה, משיב לה ומנכה את השימוש מהיתרה שלכם.

מכאן נובעת נקודה פשוטה שמבהירה מחצית מהבלבול. לא קונים מפתח כמוצר בשוק: פותחים חשבון אצל ספק, לוחצים על “יצירת מפתח” ומקבלים את המחרוזת בחינם. החיפוש “buy api key” פירושו למעשה “איפה פותחים חשבון ואיך משלמים אחר כך על השימוש”, ועל שתי השאלות האלה נענה בהמשך.

במה מפתח API שונה ממינוי ומההתחברות החינמית הישנה?#

בתוך Qwen Code, הפקודה /auth מציגה את אפשרויות האימות של הגרסה המותקנת. בחרו את הפלטפורמה שהנפיקה את המפתח ואת תוכנית החיוב שלו. ההבחנות להלן מסבירות את ההתחברות החינמית הישנה, Coding Plan והמפתח הרגיל שבמדריך; זו אינה רשימה מלאה של אפשרויות התפריט כיום.

האפשרות הראשונה היא התחברות בחינם דרך חשבון Qwen (Qwen OAuth). בעבר היא סיפקה גישה למודל בלי מפתח, אך הופסקה.

האפשרות השנייה היא מינוי Coding Plan של Alibaba ModelStudio. זהו תשלום חודשי קבוע שמעניק לכם מכסת בקשות שבועית וכתובת חיבור נפרדת.

האפשרות השלישית היא מפתח API של ספק מודלים. אין תשלום קבוע: מטעינים כסף ליתרה ומשתמשים בו במהלך העבודה, לפי מד טוקנים. האפשרות הזאת גמישה ומתאימה למי שמשתמש בסוכן באופן לא קבוע. שאר המאמר מתמקד בה.

היכן אפשר להנפיק מפתח API עבור Qwen Code?#

מכיוון ש-Qwen Code מבין פרוטוקולים שונים, אינכם מוגבלים לספק מפתחות אחד בלבד. התיעוד הרשמי מפרט במפורש את השירותים שאליהם אפשר להתחבר.

להלן דרך החיבור הישירה.

למסלול הישיר, פתחו את מסוף Alibaba Model Studio, בחרו את האזור הרצוי וצרו מפתח בדף ניהול מפתחות API. שמרו את שם האזור וסביבת העבודה לצד ההגדרות; אל תעתיקו את המפתח להערות משותפות.

מדריך האזורים ממליץ על דומיינים ייעודיים לסביבת עבודה בייצור. העתיקו את API Host האמיתי מתוך Workspace Management ופעלו לפי מדריך כתובת הבסיס; אל תמציאו מזהה סביבת עבודה. נקודות DashScope משותפות ונקודות ייעודיות לסביבת עבודה הן אפשרויות גישה שונות. גם Coding Plan ו-Token Plan משתמשים במפתחות ובנקודות קצה משלהם. העתיקו את כתובת הבסיס המלאה התואמת ל־OpenAI מקונסולת סביבת העבודה באזור שבחרתם אל DASHSCOPE_BASE_URL. השדה baseUrl מושמט מה־JSON והכתובת נמסרת דרך OPENAI_BASE_URL לפני ההפעלה. השתמשו בערכים האמיתיים מהקונסולה, ולא במזהה לדוגמה.

יש גם אפשרות בחינם, שאינה דורשת מפתח: להריץ מודל Qwen במחשב שלכם דרך Ollama ולחבר אליו את Qwen Code בתור שרת משלכם. לשם כך דרוש מחשב חזק והגדרה נפרדת. ההדרכה על הפעלת Qwen Code במסוף מסבירה כיצד להריץ את הסוכן באופן מקומי.

איך מוסיפים את המפתח ל-Qwen Code כדי שהוא יעבוד?#

גבו את ההגדרות הקיימות ומזגו את החיבור להלן אל ~/.qwen/settings.json; אל תדרסו ספקים או העדפות אחרות. ההגדרה מתבססת על דוגמת האימות של Qwen Code עם כתובת סביבת העבודה דרך OPENAI_BASE_URL, מפתח API שנקרא ממשתנה הסביבה ששמו מוגדר ב־envKey, וללא בלוק env עם הסוד בטקסט גלוי. qwen3-coder-plus הוא המודל בדוגמה הרשמית; ודאו תחילה שהוא זמין באזור ובחשבון שלכם, או השתמשו במזהה מודל אמיתי ממסוף האזור בשני המקומות.

העתיקו את כתובת הבסיס המלאה התואמת ל־OpenAI מקונסולת סביבת העבודה באזור שבחרתם אל DASHSCOPE_BASE_URL. השדה baseUrl מושמט מה־JSON והכתובת נמסרת דרך OPENAI_BASE_URL לפני ההפעלה. השתמשו בערכים האמיתיים מהקונסולה, ולא במזהה לדוגמה.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "security": { "auth": { "selectedType": "openai" } },
  "model": { "name": "qwen3-coder-plus" }
}

openai בוחר את הפרוטוקול התואם. envKey הוא שם המשתנה ש-Qwen Code קורא, ולא ערך המפתח. model.name חייב להתאים ל-id שהוגדר. מדריך ספקי המודלים מתעד שדות אלה.

ב-macOS או ב-Linux פתחו מסוף Bash והזינו את המפתח בבקשה נסתרת, ואז הפעילו Qwen Code באותו מסוף:

read -r -p 'Workspace OpenAI-compatible Base URL (copy from regional console): ' DASHSCOPE_BASE_URL
if [[ -z "$DASHSCOPE_BASE_URL" || ! "$DASHSCOPE_BASE_URL" =~ ^https:[/][/] || "$DASHSCOPE_BASE_URL" == *'{'* || "$DASHSCOPE_BASE_URL" == *'}'* ]]; then
  printf '%s\n' 'STOP: supply the real regional workspace Base URL.' >&2
else
  read -r -s -p 'DashScope API key: ' DASHSCOPE_API_KEY
  printf '\n'
  if [[ -n "$DASHSCOPE_API_KEY" ]]; then
    export DASHSCOPE_API_KEY
    export OPENAI_BASE_URL="$DASHSCOPE_BASE_URL"
    qwen
  else
    printf '%s\n' 'STOP: API key is empty.' >&2
  fi
fi

ב-Windows השתמשו ב-PowerShell:

$env:DASHSCOPE_BASE_URL = Read-Host 'Workspace OpenAI-compatible Base URL (copy from regional console)'
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_BASE_URL) -or $env:DASHSCOPE_BASE_URL -notmatch '^https:[/][/]' -or $env:DASHSCOPE_BASE_URL -match '[{}]') {
  throw 'Supply the real regional workspace Base URL.'
}
$qwenKey = Read-Host 'DashScope API key' -AsSecureString
$env:DASHSCOPE_API_KEY = [System.Net.NetworkCredential]::new('', $qwenKey).Password
if ([string]::IsNullOrWhiteSpace($env:DASHSCOPE_API_KEY)) {
  throw 'API key is empty.'
}
$env:OPENAI_BASE_URL = $env:DASHSCOPE_BASE_URL
qwen

פקודות אלה משאירות את הסוד המילולי מחוץ ל-JSON ולהיסטוריית פקודות המעטפת; התהליך הפעיל עדיין מקבל אותו בסביבה שלו. אל תדפיסו, תשמרו ב-Git או תדביקו אותו בהנחיה. הסירו הגדרת env ישנה שמכילה סוד כשעוברים למסלול זה. במסוף חדש צריך לספק את המשתנה שוב.

ב-Qwen Code השתמשו ב-/doctor לבדיקת האימות וב-/model לבדיקת הבחירה המוגדרת. בתיקיית בדיקה ריקה ולא רגישה שלחו: „השב במילה connected. אל תקרא או תשנה קבצים ואל תריץ פקודות.” תשובה מוצלחת בודקת בקשת מודל אחת ועשויה לעלות כסף. הופעת מודל ב-/model מאשרת רק את ההגדרה המקומית.

אם הבקשה נכשלת, תעדו שגיאה מושחרת ומזהה בקשה אם סופק. בדקו אימות בנפרד מזמינות המודל והחיוב: אמתו את הפלטפורמה שהנפיקה את המפתח, האזור וסביבת העבודה, נקודת קצה רגילה לעומת תוכנית, מזהה המודל והיתרה או המכסה באותו מסוף ספק. 401 יכול לנבוע מחוסר התאמה בין מפתח, נקודת קצה או תוכנית חיוב; הוא אינו מוכיח שהספק מקולקל. עצרו אחרי הבדיקה שנכשלה ותקנו את אי-ההתאמה המתועדת לפני ניסיון נוסף. המאמר מתאר דוגמה המבוססת על תיעוד, ולא בקשה בתשלום שבוצעה עבור המדריך.

כמה עולה לעבוד עם מפתח API, ומה מגדיל את החשבון?#

מפתח שונה ממינוי בכך שאין תשלום חודשי קבוע. משלמים על מה שהמודל קורא וכותב, כשהכמות נמדדת בטוקנים. טוקן הוא פיסת טקסט שאורכה בערך כמה אותיות. לכל מודל מחיר משלו למיליון טוקנים של קלט ולמיליון טוקנים של פלט, והפלט כמעט תמיד יקר יותר מהקלט.

מיליון טוקנים נשמעים כמו הרבה, אבל כשעובדים על פרויקט גדול, הכמות נגמרת מהר מכפי שנדמה: הסוכן קורא את הקבצים שלכם במלואם בכל בקשה.

הנקודה המעשית היא שהחשבון תלוי בכמות הטקסט שהסוכן מעבד. קבצים ארוכים, סשנים ארוכים וקריאות חוזרות של קוד צורכים את היתרה שלכם הכי מהר; מספר המשימות הוא עניין משני. מאמר נפרד מסביר צעד אחר צעד כיצד מחושבת צריכת הטוקנים ב-API ולמה היא עלולה להיעלם בלי שתשימו לב.

למה תשלומים נדחים?#

כאן מתרחשת טעות נפוצה.

המכשול מגיע צעד אחר כך. הנפקתם את המפתח, אבל בלי כסף ביתרה הוא לא יוכל לשמש לתשלום — הספק מחזיר שגיאת חוסר בכספים.

אם הדחייה קשורה לבנק שהנפיק את הכרטיס, שינוי כתובת הדוא״ל, שפת הממשק או הגדרות הפרופיל לא משנה את תנאי התשלום. המנגנון מוסבר באמצעות דוגמה של כרטיס זר עבור Claude.

וזכרו ששער התשלומים מקבל את ההחלטה הסופית. הוא עשוי לדחות את התשלום מסיבותיו שלו, ואין ערובה שהתשלום יעבור.

מאיפה כדאי להתחיל?#

תוכנית קצרה, צעד אחר צעד:

1. זהו את הפלטפורמה ותוכנית החיוב. Qwen OAuth החינמי הישן הופסק באפריל 2026; Coding Plan הוא מנוי נפרד, והמדריך מכסה מפתח Model Studio רגיל לפי שימוש. התפריט משתנה לפי גרסה.
2. פתחו חשבון אצל ספק. האפשרות הפשוטה ביותר היא Alibaba ישירות.
3. בחרו אזור וסביבת עבודה ב-Model Studio והנפיקו מפתח בניהול מפתחות API באותו מסוף. הנפקת מפתח נפרדת ממימון השימוש.
4. מזגו את החיבור האזורי אל ~/.qwen/settings.json ללא ערך סודי. ספקו DASHSCOPE_API_KEY במסוף שמפעיל את התוכנה, ואז בדקו את המודל שנבחר ותשובה קצרה כפי שהוצג לעיל.
5. כדי לשלם על השימוש, דרוש כרטיס שהונפק על שמכם וששער התשלומים של הספק מקבל. שער התשלומים קובע את תנאי הטעינה; הנפקת מפתח ותשלום על שימוש הם שלבים נפרדים.

כדאי גם לחשוב איזה מודל אתם צריכים. למשימות תובעניות בחרו ב-Qwen3-Coder-Plus המתקדם יותר; כדי לחסוך, בחרו ב-Flash הקל יותר, שעולה פי כמה פחות עבור אותו נפח. ההדרכה על Qwen Code כתחליף ל-Claude Code מראה במה Qwen Code שונה מסוכני מסוף אחרים.

חומרים נוספים זמינים ב-Ailoot.