Cách sử dụng API Qwen 3.7 Plus

Hướng dẫn dành cho nhà phát triển về API Qwen 3.7 Plus: lấy khóa Model Studio, gửi yêu cầu văn bản và đa phương thức (hình ảnh/video) bằng Python, curl và JavaScript, đồng thời hiểu về giá 0.40 đô la / 1.60 đô la cho mỗi 1 triệu token kèm theo các ví dụ về chi phí đã được tính toán.

Ashley Innocent

Ashley Innocent

3 tháng 6 2026

Cách sử dụng API Qwen 3.7 Plus

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

Qwen 3.7 Plus là mô hình tác tử đa phương thức của Alibaba: nhận đầu vào là văn bản, hình ảnh và video, có ngữ cảnh 1M token và mức giá phải chăng. Vì nó chỉ được cung cấp dưới dạng API, các câu hỏi thực tế sẽ xuất hiện ngay lập tức. Làm thế nào để tôi có được khóa, làm thế nào để tôi gửi một hình ảnh, và chi phí là bao nhiêu? Hướng dẫn này sẽ trả lời cả ba câu hỏi đó.

Chúng ta sẽ đề cập đến cách truy cập, cách lấy khóa, yêu cầu đầu tiên của bạn trong Python, curl và JavaScript, định dạng tải trọng đa phương thức, phân tích chi tiết giá cả với các ví dụ chi phí cụ thể, và giới hạn tốc độ. Trong quá trình này, bạn sẽ sử dụng Apidog để gửi các yêu cầu thử nghiệm, kiểm tra phản hồi thô và mô phỏng điểm cuối để ứng dụng của bạn tiếp tục được xây dựng. Nếu bạn muốn biết trước về khả năng và hiệu suất, hãy bắt đầu với tổng quan về Qwen 3.7 Plus của chúng tôi; đối với phiên bản hàng đầu chỉ dành cho văn bản, hãy xem hướng dẫn API Qwen 3.7 cơ bản.

tải ứng dụng

Tóm tắt

Qwen 3.7 Plus hoạt động thông qua Alibaba Cloud Model Studio trên một điểm cuối tương thích OpenAI. Bạn đặt URL cơ sở theo khu vực, truyền khóa của mình dưới dạng Bearer token và gọi /chat/completions với ID mô hình qwen3.7-plus. Các yêu cầu đa phương thức thêm các phần hình ảnh hoặc video vào nội dung tin nhắn. Giá là 0,40 đô la cho mỗi triệu token đầu vào và 1,60 đô la cho mỗi triệu token đầu ra, với đầu vào được lưu trong bộ nhớ cache là 0,08 đô la, rẻ hơn khoảng sáu lần so với Qwen3.7-Max. Không có gói miễn phí vĩnh viễn, mặc dù các tài khoản mới được cấp một hạn ngạch miễn phí một lần. Token thị giác chia sẻ ngân sách ngữ cảnh, vì vậy hình ảnh và video sẽ làm tăng hóa đơn của bạn. Hãy xác nhận ID mô hình chính xác trong tài liệu Model Studio trước khi triển khai.

Cách truy cập Qwen 3.7 Plus

Không giống như phiên bản hàng đầu chỉ dành cho văn bản, vốn đã trải qua giai đoạn đầu sau bản xem trước chỉ trò chuyện, Plus là một API thương mại ngay từ ngày đầu tiên. Có hai bề mặt quan trọng.

Qwen Chat (chat.qwen.ai). Cách nhanh nhất để thử Plus với hình ảnh. Đăng nhập, chọn mô hình Plus, thả vào một ảnh chụp màn hình và xem cách nó hoạt động. Đây là để đánh giá, không phải để tích hợp.

Alibaba Cloud Model Studio (DashScope). Đây là API thực sự. Model Studio cung cấp Plus thông qua một điểm cuối tương thích OpenAI, vì vậy bất kỳ mã nào đã giao tiếp với OpenAI SDK đều có thể gọi nó bằng cách hoán đổi URL cơ sở và khóa.

Một giới hạn khó khăn cần lưu ý: Plus là độc quyền. Không có trọng số mở để tải xuống, vì vậy bạn không thể tự lưu trữ hoặc chạy nó ngoại tuyến. Nếu đó là một yêu cầu, tổng quan về Qwen 3.7 Plus của chúng tôi sẽ đề cập chi tiết về vấn đề này.

Phương pháp Truy cập API Chi phí Tốt nhất cho
Qwen Chat (chat.qwen.ai) Không Miễn phí, giới hạn tốc độ Đánh giá nhanh với hình ảnh
Model Studio (DashScope) Có, tương thích OpenAI Trả tiền theo token Tích hợp sản xuất
Tự lưu trữ Không không áp dụng Không khả dụng; trọng số đã đóng

Lấy khóa API Qwen 3.7 Plus

Truy cập thông qua tài khoản Alibaba Cloud.

  1. Tạo tài khoản Alibaba Cloud và mở bảng điều khiển Model Studio (modelstudio.console.alibabacloud.com).
  2. Kích hoạt Model Studio cho tài khoản và khu vực của bạn. Khóa được giới hạn theo khu vực, vì vậy khóa Singapore sẽ không xác thực được với Bắc Kinh.
  3. Mở phần khóa API và tạo khóa. Nó trông giống như sk- theo sau một chuỗi.
  4. Sao chép một lần và lưu trữ nó như một mật khẩu.

Khu vực của bạn đặt URL cơ sở của bạn:

Khu vực URL cơ sở
Singapore https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Hoa Kỳ (Virginia) https://dashscope-us.aliyuncs.com/compatible-mode/v1
Bắc Kinh (Trung Quốc) https://dashscope.aliyuncs.com/compatible-mode/v1

Giữ khóa ngoài tầm kiểm soát nguồn. Sử dụng một biến môi trường:

# macOS / Linux
export DASHSCOPE_API_KEY="sk-your-key-here"

# Windows PowerShell
setx DASHSCOPE_API_KEY "sk-your-key-here"

Yêu cầu đầu tiên của bạn: Python, curl và JavaScript

Điểm cuối tương thích với OpenAI, vì vậy bạn có thể sử dụng OpenAI SDK chính thức trỏ đến URL cơ sở của DashScope, hoặc một lệnh gọi HTTP thô. ID mô hình là qwen3.7-plus, nhưng hãy xác nhận chuỗi hiện tại trong danh sách mô hình Model Studio trước khi triển khai, vì các định danh có thể thay đổi.

Python với OpenAI SDK

Cài đặt bằng pip install openai, sau đó:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[{"role": "user", "content": "Tóm tắt mô hình định giá Qwen 3.7 Plus trong hai câu."}],
)
print(resp.choices[0].message.content)

curl

curl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [{"role": "user", "content": "Xin chào từ API Qwen 3.7 Plus."}]
  }'

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DASHSCOPE_API_KEY,
  baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
});

const resp = await client.chat.completions.create({
  model: "qwen3.7-plus",
  messages: [{ role: "user", content: "Xin chào từ API Qwen 3.7 Plus." }],
});
console.log(resp.choices[0].message.content);

Gửi hình ảnh và video

Lý do để sử dụng Plus thay vì Max là đầu vào đa phương thức. Bạn truyền nội dung hình ảnh dưới dạng các phần bổ sung trong mảng content của tin nhắn, cùng định dạng mà OpenAI vision API sử dụng.

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Nút nào gửi biểu mẫu này? Cho tọa độ pixel."},
            {"type": "image_url", "image_url": {"url": "https://example.com/screenshot.png"}},
        ],
    }],
)

Bạn có thể truyền một hình ảnh dưới dạng URL công khai hoặc URI dữ liệu base64. Video cũng theo cùng một mẫu với một phần video. Đây là điều cung cấp năng lượng cho hành vi định vị GUI: đưa cho Plus một ảnh chụp màn hình, và nó sẽ trả về các hành động có cấu trúc như click at (x=487, y=232). Tên các phần chính xác cho video có thể khác nhau tùy theo khu vực, vì vậy hãy kiểm tra tài liệu tương thích OpenAI để biết lược đồ hiện tại.

Giá cả

Plus được định giá là một cấp độ đa phương thức tiết kiệm. Đây là cách nó so sánh với phiên bản hàng đầu chỉ dành cho văn bản.

Mô hình Đầu vào / 1M Đầu ra / 1M Đầu vào đã lưu / 1M
Qwen 3.7 Plus 0,40 đô la 1,60 đô la 0,08 đô la
Qwen 3.7 Max 2,50 đô la 7,50 đô la 0,25 đô la

Điều đó có nghĩa là rẻ hơn khoảng sáu lần so với Max về đầu vào. Không có gói miễn phí vĩnh viễn, nhưng các tài khoản Model Studio mới sẽ nhận được một hạn ngạch token miễn phí một lần (thường ở khu vực Singapore) để đánh giá mô hình trước khi chuyển sang thanh toán theo mức sử dụng. Lưu ý rằng đường dẫn miễn phí Qwen OAuth cũ đã ngừng hoạt động vào ngày 15 tháng 4 năm 2026, vì vậy đừng xây dựng trên đó. Các con số chính thức có trên trang giá của Model Studiohướng dẫn hạn ngạch miễn phí; để biết các cách không tốn phí để dùng thử các phiên bản khác, hãy xem hướng dẫn Qwen 3.7 miễn phí của chúng tôi.

Chi phí thực tế của các yêu cầu

Văn bản rẻ. Thị giác là nơi hóa đơn tăng lên, bởi vì hình ảnh và video được chuyển đổi thành token chia sẻ cùng mức giá trên mỗi token và cùng ngân sách ngữ cảnh 1M. Một ảnh chụp màn hình độ phân giải cao có thể lên đến vài nghìn token, và các khung video tích lũy nhanh chóng.

Yêu cầu Token đầu vào Token đầu ra Chi phí ước tính
Lời nhắc chỉ văn bản 10.000 2.000 ~0,007 đô la
Một ảnh chụp màn hình 1080p + lời nhắc ~1.500 300 ~0,001 đô la
Video 30 giây được lấy mẫu ở 2 khung hình/giây ~77.000 500 ~0,032 đô la

Các con số token khung hình là gần đúng và phụ thuộc vào độ phân giải và tốc độ lấy mẫu, nhưng bài học vẫn đúng: một tác tử văn bản trên Plus gần như không tốn kém gì, trong khi một khối lượng công việc nặng về video có thể tốn gấp 30 lần cho mỗi lần gọi. Giảm kích thước ảnh chụp màn hình và lấy mẫu video một cách tiết kiệm. Để biết chiến lược chi phí rộng hơn, hãy xem ghi chú của chúng tôi về giảm chi phí token tác tửcuộc chiến giá LLM Trung Quốc năm 2026 đã đưa Plus đến mức giá này ngay từ đầu.

Giới hạn tốc độ và lỗi

Model Studio áp dụng giới hạn tốc độ trên mỗi tài khoản về số yêu cầu mỗi phút và số token mỗi phút, và các mức trần phụ thuộc vào cấp độ tài khoản và khu vực của bạn chứ không phải một con số được công bố duy nhất. Kiểm tra trang hạn ngạch trong bảng điều khiển để biết giới hạn hiện tại của bạn và yêu cầu tăng nếu bạn đạt đến chúng.

Xử lý các lỗi thường gặp:

Thực hiện các lệnh gọi trong một vòng lặp thử lại với độ trễ đối với lỗi 429 và 5xx, và xác thực kích thước hình ảnh trước khi gửi.

Kiểm tra và mô phỏng API với Apidog

Các yêu cầu đa phương thức rất dễ mắc lỗi. Bạn đang mã hóa base64 hình ảnh, lồng các mảng nội dung và đọc lại các kế hoạch hành động có cấu trúc, thường là bên trong một vòng lặp gọi công cụ. Việc xem xét kỹ điều đó trong một thiết bị đầu cuối sẽ nhanh chóng trở nên nhàm chán.

Apidog cung cấp cho bạn một không gian làm việc thực sự cho việc đó. Gửi các yêu cầu Qwen 3.7 Plus với các phần hình ảnh và video, kiểm tra phản hồi JSON thô, lưu trữ khóa Model Studio của bạn theo từng môi trường để bạn không bao giờ phải dán nó vào mã, và mô phỏng điểm cuối để giao diện người dùng của bạn được xây dựng trong khi bạn điều chỉnh các lời nhắc. Khi Plus đang xâu chuỗi các lệnh gọi công cụ trong quá trình chạy tác tử GUI-và-CLI, trình gỡ lỗi tác tử AI của Apidog hiển thị toàn bộ chuỗi để bạn có thể tìm ra nơi quá trình chạy bị lỗi.

Tải Apidog để kiểm tra, gỡ lỗi và mô phỏng API Qwen 3.7 Plus trước khi đưa vào sản xuất.

Câu hỏi thường gặp

Có gói miễn phí cho API Qwen 3.7 Plus không? Không có gói miễn phí vĩnh viễn. Các tài khoản Alibaba Cloud Model Studio mới sẽ nhận được một hạn ngạch token miễn phí một lần để đánh giá, thường ở khu vực Singapore, sau đó việc thanh toán chuyển sang hình thức trả tiền theo mức sử dụng.

ID mô hình là gì? qwen3.7-plus trên Model Studio. Vì các định danh có thể thay đổi, hãy xác nhận chuỗi hiện tại trong danh sách mô hình Model Studio trước khi bạn triển khai.

Chi phí hình ảnh và video được tính như thế nào? Nội dung hình ảnh được chuyển đổi thành token và được tính phí theo mức giá đầu vào tiêu chuẩn. Một ảnh chụp màn hình 1080p có thể tốn vài nghìn token, và video thêm token cho mỗi khung hình được lấy mẫu, vì vậy các tải trọng phương tiện lớn sẽ chiếm phần lớn hóa đơn.

API này khác với Qwen 3.7 Max như thế nào? Cùng định dạng tương thích OpenAI và URL cơ sở. Plus chấp nhận các phần hình ảnh và video trong nội dung tin nhắn và chi phí thấp hơn khoảng sáu lần; Max chỉ dùng văn bản và giữ một lợi thế nhỏ về các điểm chuẩn chỉ văn bản thuần túy.

Tôi có thể tự lưu trữ Qwen 3.7 Plus không? Không. Trọng số đã được đóng, vì vậy nó chỉ chạy thông qua Alibaba Cloud Model Studio.

Tôi nên sử dụng URL cơ sở nào? URL phù hợp với khu vực bạn đã tạo khóa: Singapore, Hoa Kỳ (Virginia) hoặc Bắc Kinh. Khóa sẽ không xác thực được với điểm cuối của một khu vực khác.

Kết luận

Việc gọi Qwen 3.7 Plus là một thao tác hoán đổi URL cơ sở và khóa trên OpenAI SDK, cộng với các phần hình ảnh hoặc video khi bạn cần thị giác. Giá cả thực sự rẻ đối với văn bản và tăng theo tải trọng hình ảnh của bạn, vì vậy kỷ luật nằm ở số lượng pixel bạn gửi, chứ không phải bản thân API. Lấy khóa, gửi yêu cầu đa phương thức đầu tiên của bạn và kiểm tra toàn bộ quy trình trong Apidog trước khi bạn đưa nó vào sản xuất.

tải ứng dụng

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API