Token Plan (Phiên bản Nhóm)
Không sử dụng như một quyền gọi trực tiếp tổng quát; hãy dùng đường dẫn API chung để kiểm thử và tích hợp ứng dụng.
Kết hợp công cụ + mô hình
Postman / cURL với API của Alibaba Model Studio
Đường dẫn kiểm thử API để xác minh yêu cầu, tiêu đề, dữ liệu đầu vào và hành vi của điểm cuối Model Studio.
Postman và cURL hữu ích để kiểm tra cấu trúc yêu cầu, header và hành vi mô hình, nhưng đây là các giao diện gọi trực tiếp API, chứ không phải công cụ lập trình tương tác hoặc agent.
Chọn phương thức truy cập phù hợp
Chọn phương thức truy cập phù hợp
Sử dụng khóa API chung của Model Studio pay-as-you-go và điểm cuối khu vực tương ứng. Alibaba rõ ràng không khuyến nghị gọi Coding Plan từ Postman.
Được đề xuấtPay-as-you-go Model Studio API
Coding Plan
Alibaba Cloud khẳng định rõ ràng rằng các cuộc gọi Postman không được khuyến nghị và cấm các tình huống sử dụng API phi tương tác.
Pay-as-you-go Model Studio API
Đây là lựa chọn phù hợp để xác thực thủ công API, chạy script, kiểm thử tích hợp và phát triển backend.
Mẫu cấu hình an toàn
Kiểm thử endpoint Model Studio tương thích OpenAI chung
Ví dụ được chủ ý ẩn đi. Chỉ thay thế các phần giữ chỗ trên thiết bị của bạn và tuyệt đối không dán khóa API thực tế vào Nfero.
Trước khi bắt đầu
- Tạo một khóa API chung của Model Studio trong khu vực triển khai.
- Chọn một mô hình được hỗ trợ cho cùng khu vực và giao thức API.
- Lưu khóa vào biến bí mật / giá trị hiện tại của Postman hoặc một biến môi trường.
- Thiết lập cảnh báo thanh toán trước khi lặp lại hoặc tự động hóa các yêu cầu.
Mẫu cấu hình an toàn
- Giao thức
- OpenAI-compatible Model Studio API
- Sử dụng endpoint chung theo khu vực được nêu trong tài liệu URL gốc của Alibaba.
- Gửi khóa trong header Authorization mà không in ra hay đưa vào kho lưu trữ (commit).
- Bắt đầu với prompt ngắn và giới hạn đầu ra thấp.
- Di chuyển mã sản xuất sang hệ thống lưu trữ bí mật phía máy chủ sau khi yêu cầu đã được xác thực.
Xác minh kết nối
- Xác nhận vùng (region) của khóa khớp với endpoint.
- Kiểm tra mã trạng thái phản hồi, Request ID, ID mô hình và các trường sử dụng.
- Đảm bảo bộ sưu tập Postman đã xuất không chứa giá trị bí mật hiện tại.
- Xác nhận endpoint là endpoint chung của Model Studio — không phải URL đặc thù cho từng gói dịch vụ.
Kết hợp mô hình
Các mô hình đề xuất để bắt đầu
Sử dụng công cụ này để thực hiện các nhiệm vụ lập trình tương tác, suy luận, kiểm tra và tài liệu với mỗi mô hình. Xác nhận khả năng sẵn có của mô hình cuối cùng và hỗ trợ kế hoạch chính xác trong Alibaba Cloud trước khi sử dụng trong sản xuất.
Qwenqwen3.7-plus
Tạo văn bảnLập luậnHiểu biết trực quan
Góc kết hợp tốt nhất
Tuyến mô hình đa dụng hiện tại; xác minh tính khả dụng trong khu vực của khóa.
Qwenqwen3.6-flash
Tạo văn bảnLập luậnHiểu biết trực quan
Góc kết hợp tốt nhất
Tùy chọn hiệu quả để kiểm tra dạng yêu cầu và kiểm tra tích hợp cơ bản.
Các sự cố thường gặp
Các sự cố thường gặp
Hiện tượng bạn gặp phải
Lỗi 401: Khóa API không đúng
Nguyên nhân có khả năng xảy ra
Khóa bị thiếu, bị cắt ngắn hoặc thuộc gói dịch vụ/khu vực khác.
Cần làm gì
Sử dụng khóa chung từ cùng khu vực và workspace Model Studio với endpoint.
Hiện tượng bạn gặp phải
Gói dịch vụ bị tạm ngưng bất ngờ hoặc khóa bị chặn
Nguyên nhân có khả năng xảy ra
Đã sử dụng khóa Coding Plan hoặc Token Plan cho các yêu cầu API trực tiếp hoặc tự động.
Cần làm gì
Thay thế bằng khóa API chung của pay-as-you-go Model Studio.
Các hạn chế quan trọng
- Không bao giờ dán khóa thực vào Nfero, một bộ sưu tập công khai, lịch sử lệnh nhằm chia sẻ hoặc hệ thống kiểm soát nguồn.
- Không sử dụng thông tin xác thực Coding Plan hoặc Token Plan cho kịch bản trực tiếp, kiểm thử hàng loạt hoặc gọi từ phía máy chủ.
- Sử dụng giới hạn thấp và cảnh báo thanh toán trong quá trình xác thực hành vi yêu cầu.