API key Qwen Code: Tạo key ở đâu, cách kết nối và tính mức sử dụng

Có người cài Qwen Code, khởi chạy trong terminal, và ngay ở yêu cầu đầu tiên, chương trình đã hỏi key. Thế là họ bắt đầu tìm kiếm: mọi người nhập “buy api key for qwen code” và truy cập các trang bán gói đăng ký hoặc quyền truy cập có sẵn của người khác. Bài viết này giải thích key là gì, lấy ở đâu và chi phí bao nhiêu, từng bước một.

Điểm chính ngay từ đầu: không ai bán API key như một sản phẩm đóng hộp riêng. Đó là chuỗi truy cập do chính bạn tạo trong tài khoản của nhà cung cấp mô hình, và việc tạo key là miễn phí. Sau đó bạn mới cần tiền để nạp số dư; ở bước này, điều khoản của nhà cung cấp sẽ được áp dụng. Dưới đây là nơi lấy key, cách kết nối key với Qwen Code và chi phí sử dụng.

API key cho Qwen Code chính xác là gì?#

Qwen Code là một agent AI mã nguồn mở chạy trong terminal và viết mã cho các tác vụ của bạn. Công cụ này miễn phí, được cài đặt thông qua npm và không có mạng nơ-ron riêng bên trong. Mô hình đảm nhiệm toàn bộ công việc thông minh và chạy trên máy chủ của nhà cung cấp.

Qwen Code cần một tấm vé để truy cập mô hình. Tấm vé đó là API key — một chuỗi dài giống mật khẩu do nhà cung cấp cấp riêng cho bạn. Khi agent gửi yêu cầu, nó đính kèm key; nhà cung cấp dùng key để xác định yêu cầu thuộc về ai, phản hồi và trừ mức sử dụng khỏi số dư của bạn.

Điều này dẫn đến một điểm đơn giản giúp làm rõ một nửa sự nhầm lẫn. Bạn không mua key như một sản phẩm trên sàn giao dịch: bạn tạo tài khoản với nhà cung cấp, nhấn “tạo key” và nhận chuỗi này miễn phí. Tìm kiếm “buy api key” thực chất có nghĩa là “tôi tạo tài khoản ở đâu và sau đó thanh toán cho mức sử dụng như thế nào”, và cả hai câu hỏi đều được giải đáp bên dưới.

API key khác gì so với gói đăng ký và cách đăng nhập miễn phí trước đây?#

Trong Qwen Code, /auth hiển thị lựa chọn xác thực được phiên bản đang cài hỗ trợ. Chọn đúng nền tảng cấp key và gói tính phí của nó. Phần dưới phân biệt đăng nhập miễn phí cũ, Coding Plan và API key tiêu chuẩn dùng trong bài; đây không phải danh sách đầy đủ các mục menu hiện nay.

Lựa chọn đầu tiên là đăng nhập miễn phí bằng tài khoản Qwen (Qwen OAuth). Trước đây, cách này cung cấp quyền truy cập mô hình mà không cần key, nhưng đã ngừng hoạt động.

Lựa chọn thứ hai là gói đăng ký Coding Plan của Alibaba ModelStudio. Đây là khoản phí cố định hàng tháng, cung cấp hạn mức yêu cầu hàng tuần và một địa chỉ kết nối riêng.

Lựa chọn thứ ba là API key từ một nhà cung cấp mô hình. Không có phí cố định: bạn nạp tiền vào số dư và sử dụng khi làm việc, theo lượng token. Lựa chọn này linh hoạt và phù hợp nếu bạn không dùng agent thường xuyên. Phần còn lại của bài viết tập trung vào cách này.

Có thể tạo API key cho Qwen Code ở đâu?#

Vì Qwen Code hiểu nhiều giao thức khác nhau, bạn không bị giới hạn ở một nhà cung cấp key duy nhất. Tài liệu chính thức liệt kê cụ thể các dịch vụ mà công cụ có thể kết nối.

Dưới đây là cách kết nối trực tiếp.

Để kết nối trực tiếp, mở bảng điều khiển Alibaba Model Studio, chọn vùng cần dùng và tạo key trong trang quản lý API key. Giữ tên vùng và workspace cùng cấu hình; đừng chép key vào ghi chú chia sẻ.

Hướng dẫn vùng khuyến nghị tên miền riêng của workspace cho production. Chép API Host thật từ Workspace Management và theo hướng dẫn base URL; đừng tự đặt workspace ID. Endpoint DashScope dùng chung và endpoint riêng của workspace là các cách truy cập khác nhau. Coding Plan và Token Plan cũng dùng endpoint và key riêng. Chép Base URL đầy đủ tương thích OpenAI từ bảng điều khiển workspace ở vùng đã chọn vào DASHSCOPE_BASE_URL. JSON bỏ baseUrl; trước khi chạy, địa chỉ được cấp qua OPENAI_BASE_URL. Dùng giá trị thật từ bảng điều khiển, không dùng ký hiệu thay thế ID workspace.

Ngoài ra còn có lựa chọn miễn phí, không cần key: chạy mô hình Qwen trên máy tính của bạn thông qua Ollama và kết nối Qwen Code với mô hình đó như một máy chủ riêng. Cách này cần một máy tính mạnh và quy trình thiết lập riêng. Hướng dẫn khởi chạy Qwen Code trong terminal trình bày cách chạy agent cục bộ.

Thêm key vào Qwen Code như thế nào để công cụ hoạt động?#

Sao lưu cài đặt hiện có và ghép kết nối dưới đây vào ~/.qwen/settings.json; đừng ghi đè nhà cung cấp hoặc tùy chọn không liên quan. Cấu hình minh họa theo ví dụ xác thực Qwen Code với URL workspace được truyền qua OPENAI_BASE_URL, khóa API được đọc từ biến môi trường do envKey chỉ định và không có khối env chứa bí mật dạng văn bản thuần. qwen3-coder-plus là mô hình trong ví dụ chính thức; trước hết xác minh vùng/tài khoản đã chọn cung cấp nó, hoặc dùng ID mô hình thật từ bảng điều khiển của vùng đó ở cả hai chỗ.

Chép Base URL đầy đủ tương thích OpenAI từ bảng điều khiển workspace ở vùng đã chọn vào DASHSCOPE_BASE_URL. JSON bỏ baseUrl; trước khi chạy, địa chỉ được cấp qua OPENAI_BASE_URL. Dùng giá trị thật từ bảng điều khiển, không dùng ký hiệu thay thế ID workspace.

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

openai chọn giao thức tương thích. envKey là tên biến Qwen Code đọc, không phải giá trị key. model.name phải khớp id đã cấu hình. Tài liệu nhà cung cấp mô hình mô tả các trường này.

Trên macOS hoặc Linux, mở terminal Bash, nhập key vào lời nhắc ẩn ký tự rồi khởi chạy Qwen Code trong cùng terminal:

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

Trên Windows, dùng 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

Các lệnh giữ giá trị bí mật ngoài JSON và lịch sử lệnh shell; tiến trình đang chạy vẫn nhận nó qua môi trường. Đừng in, commit hoặc dán nó vào prompt. Xóa mục env cũ chứa bí mật khỏi cài đặt khi dùng cách này. Terminal mới cần được cấp lại biến.

Trong Qwen Code, dùng /doctor xem xác thực và /model kiểm tra lựa chọn đã cấu hình. Trong thư mục thử nghiệm trống, an toàn, gửi: “Reply with the word connected. Do not read or change files or run commands.” Câu trả lời thành công kiểm tra một yêu cầu mô hình và có thể phát sinh phí. Mô hình xuất hiện trong /model chỉ xác nhận cấu hình cục bộ.

Nếu yêu cầu thất bại, ghi lỗi đã che thông tin bí mật và ID yêu cầu nếu có. Kiểm tra xác thực riêng với mô hình và thanh toán: xác minh nền tảng cấp key, vùng/workspace, endpoint tiêu chuẩn hay theo gói, ID mô hình và số dư/hạn mức trong cùng bảng điều khiển nhà cung cấp. Mã 401 có thể phản ánh key/endpoint hoặc gói thanh toán không khớp; không chứng minh nhà cung cấp bị hỏng. Dừng sau lần kiểm tra thất bại và sửa điểm không khớp theo tài liệu trước khi thử lại. Bài này mô tả ví dụ dựa trên tài liệu, không phải yêu cầu có tính phí đã được thực hiện cho hướng dẫn.

Dùng API key tốn bao nhiêu và điều gì khiến hóa đơn tăng?#

Key khác với gói đăng ký ở chỗ không có khoản phí cố định hàng tháng. Bạn trả tiền cho những gì mô hình đọc và ghi, được đo bằng token. Token là một phần văn bản dài khoảng vài chữ cái. Mỗi mô hình có giá riêng cho một triệu token đầu vào và một triệu token đầu ra; đầu ra hầu như luôn đắt hơn đầu vào.

Một triệu token nghe có vẻ nhiều, nhưng khi làm việc với một dự án lớn, lượng đó hết nhanh hơn bạn tưởng: agent đọc toàn bộ tệp của bạn trong mỗi yêu cầu.

Điểm thực tế cần nhớ là hóa đơn phụ thuộc vào lượng văn bản agent xử lý. Tệp dài, phiên làm việc dài và việc đọc đi đọc lại mã liên tục sẽ làm số dư cạn nhanh nhất; số lượng tác vụ chỉ là yếu tố thứ yếu. Một bài viết riêng giải thích từng bước cách tính mức sử dụng token API và vì sao lượng token có thể cạn đi mà bạn không nhận ra.

Vì sao thanh toán bị từ chối?#

Đây là lúc một sai lầm phổ biến xảy ra.

Trở ngại xuất hiện ở bước tiếp theo. Bạn đã tạo key, nhưng nếu số dư chưa có tiền thì key không thể chi trả bất cứ thứ gì — nhà cung cấp sẽ trả về lỗi không đủ tiền.

Nếu việc từ chối liên quan đến ngân hàng phát hành thẻ, thay đổi email, ngôn ngữ giao diện hoặc cài đặt hồ sơ không làm thay đổi điều khoản thanh toán. Cơ chế này được giải thích qua ví dụ thẻ nước ngoài cho Claude.

Hãy nhớ rằng cổng thanh toán là bên đưa ra quyết định cuối cùng. Cổng có thể từ chối thanh toán vì lý do riêng và không có gì đảm bảo giao dịch sẽ thành công.

Nên bắt đầu từ đâu?#

Kế hoạch ngắn gọn theo từng bước:

1. Kiểm tra nền tảng và gói trong menu của phiên bản đang cài. Gói Qwen OAuth miễn phí cũ dừng vào tháng 4 năm 2026; Coding Plan dùng thuê bao và endpoint riêng. Bài này dùng API key tiêu chuẩn trả theo mức sử dụng, không liệt kê toàn bộ menu.
2. Tạo tài khoản với nhà cung cấp. Lựa chọn đơn giản nhất là Alibaba trực tiếp.
3. Tạo key trong tài khoản nhà cung cấp, tại mục khóa truy cập. Tạo key miễn phí; bạn không cần thẻ cho bước này.
4. Ghép kết nối theo vùng vào ~/.qwen/settings.json mà không có giá trị bí mật. Cấp DASHSCOPE_API_KEY trong terminal khởi chạy, sau đó kiểm tra mô hình đã chọn và một câu trả lời ngắn như trên.
5. Để trả phí sử dụng, bạn cần một thẻ phát hành dưới tên mình và được cổng thanh toán của nhà cung cấp chấp nhận. Cổng thanh toán quy định điều khoản nạp tiền; tạo key và trả phí sử dụng là hai bước riêng biệt.

Bạn cũng nên cân nhắc cần mô hình nào. Với các tác vụ đòi hỏi cao, hãy chọn Qwen3-Coder-Plus cao cấp hơn; để tiết kiệm, hãy chọn Flash nhẹ hơn, có giá thấp hơn vài lần với cùng khối lượng sử dụng. Hướng dẫn về Qwen Code như một lựa chọn thay thế cho Claude Code cho thấy Qwen Code khác các agent terminal khác như thế nào.

Có thêm tài liệu tại Ailoot.