Bắt đầu với Max Router
Chọn mô hình, tạo khóa API và gửi yêu cầu đầu tiên qua Max Router.

Chọn mô hình và điểm cuối
Mở danh mục để so sánh mô hình, điểm cuối được hỗ trợ và giá hiện tại. Chọn mô hình phù hợp với đầu vào và đầu ra của ứng dụng, rồi ghi lại chính xác ID của mô hình.
Khi tích hợp thất bại, điều khó nhất thường là biết lỗi ở tầng nào. Hãy chọn mô hình hỗ trợ endpoint hội thoại và gửi một câu hỏi ngắn. Để hình ảnh, công cụ, streaming và chỉ dẫn phức tạp cho bước sau. Yêu cầu nhỏ giúp kiểm tra riêng địa chỉ, khóa, ID mô hình và định dạng trước khi thêm các khả năng sản phẩm cần.
Danh mục cho biết ID chính xác, endpoint được hỗ trợ và giá hiện tại. Tên hiển thị có thể khác mã cần dùng trong chương trình; đừng tự đoán dấu câu hay phiên bản. Endpoint văn bản không tự động phù hợp cho tác vụ ảnh hoặc video. Khi đổi mô hình, hãy kiểm tra lại khả năng và tham số quan trọng trong tài liệu.
Tạo khóa API
Đăng nhập và tạo khóa tại trang khóa API. Lưu khóa trong biến môi trường hoặc trình quản lý bí mật; không đưa khóa thật vào mã trình duyệt hay kho mã công khai.
Dùng thông tin xác thực riêng cho từng môi trường để dễ giới hạn và điều tra. Máy chủ đọc khóa từ biến môi trường hoặc trình quản lý bí mật. Bản frontend, tiện ích trình duyệt và kho mã công khai không phải nơi giữ bí mật, kể cả khi biến build có chữ SECRET. Nếu khóa lộ trong ảnh hoặc nhật ký, hãy thay khóa và kiểm tra mức sử dụng.
Ứng dụng kết nối tới các mô hình văn bản, hình ảnh và video qua cổng API.Gửi yêu cầu
Ví dụ dưới đây dùng điểm cuối chat completions. Thay YOUR_MODEL_ID bằng mô hình tương thích và đặt biến MAX_ROUTER_API_KEY. Với hình ảnh hoặc video, hãy dùng điểm cuối trong tài liệu của mô hình.
curl https://maxrouterai.com/v1/chat/completions \
-H "Authorization: Bearer $MAX_ROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello!"}]}'
Kiểm tra kết quả
Kiểm tra phản hồi và lỗi, sau đó xem mức sử dụng trên bảng điều khiển. Thử các tham số cần thiết bằng yêu cầu nhỏ trước khi thêm streaming hoặc công cụ.
Nếu yêu cầu đầu tiên thất bại
Kiểm tra chính xác ID mô hình và endpoint trong danh mục. Lỗi xác thực cần kiểm tra khóa và quyền; tham số không hỗ trợ cần sửa yêu cầu. Đừng đăng khóa trong câu hỏi công khai; mã yêu cầu và lỗi đã loại thông tin nhạy cảm thường hữu ích hơn.
Mã HTTP thành công mới là bước đầu: cần xem nội dung, trường bắt buộc và trạng thái hoàn tất. Khi lỗi, giữ mã yêu cầu và thông báo đã loại dữ liệu nhạy cảm. Lỗi xác thực cần kiểm tra khóa và quyền; tham số sai cần sửa yêu cầu. Giới hạn tốc độ hoặc lỗi tạm thời có thể được thử lại với giới hạn theo tài liệu, không phải vòng lặp vô tận.
Chia một yêu cầu thành ba giai đoạn
Trình duyệt nên gửi câu hỏi tới máy chủ của bạn trước. Máy chủ xác thực người dùng, kiểm tra dữ liệu rồi gọi mô hình bằng khóa được lưu phía máy chủ. Chỉ kết quả cần thiết được trả về trình duyệt; khóa của nền tảng không nên xuất hiện trong mã phía người dùng.
Khi có lỗi, hãy kiểm tra từng chặng: trình duyệt đã kết nối tới máy chủ chưa, máy chủ đã gửi tới API chưa và API có phản hồi không. Mã yêu cầu, trạng thái và thời gian thường hữu ích hơn việc ghi toàn bộ cuộc hội thoại. Hãy so sánh một yêu cầu tối thiểu trên dòng lệnh với yêu cầu từ ứng dụng.
Tìm nguyên nhân trong phản hồi
Trạng thái HTTP thành công chưa phải là bước kiểm tra cuối cùng. Hãy tìm nội dung trả về và xem ứng dụng xử lý phản hồi rỗng, lý do kết thúc hoặc việc mô hình từ chối như thế nào. Cấu trúc phản hồi khác nhau theo giao thức.
Với lỗi xác thực, kiểm tra khóa, môi trường, quyền và tiêu đề yêu cầu. Với tham số sai, giữ lại các trường bắt buộc rồi thêm từng trường. Khi cần hỗ trợ, chỉ chia sẻ mã yêu cầu và lỗi đã loại bỏ thông tin nhạy cảm. Nếu nghi khóa bị lộ, hãy thu hồi hoặc thay khóa.
Thử nghiệm quy mô nhỏ trước khi triển khai
Trước khi triển khai, thử câu hỏi ngắn, đầu vào dài, thiếu trường bắt buộc, khóa sai và việc hủy yêu cầu. Kiểm tra trạng thái tải và lỗi, thời gian chờ trên máy chủ và thao tác nhấn lặp; dùng dữ liệu thử không chứa thông tin khách hàng.
Cho một nhóm nhỏ thử các tác vụ thực tế, ghi lại chất lượng, thời gian, mức sử dụng và lỗi. Lưu tên mô hình, giao diện, phiên bản phụ thuộc và ngày kiểm tra để có thể chạy lại cùng bộ mẫu sau khi thay đổi.
Tiến từng bước
Khi yêu cầu nhỏ đã chạy, hãy thử đầu vào gần với công việc thực tế. Thêm từng khả năng, giữ thông tin xác thực trên máy chủ và xem mức sử dụng trước khi tăng lưu lượng. Tài liệu mô hình cho biết giới hạn và tùy chọn hiện tại.
Dùng ví dụ đại diện không chứa dữ liệu nhạy cảm thật, ghi lại chất lượng, độ trễ, mức sử dụng và lỗi. Thử khóa sai, mất mạng và người dùng hủy để kiểm tra thông báo. Khi luồng cơ bản ổn định, tăng lưu lượng dần. Khả năng, giá và giới hạn có thể thay đổi, vì vậy hãy xem lại tài liệu trước khi triển khai lớn.
Ghi ID mô hình, endpoint, thiết lập không nhạy cảm và ngày thử thành công đầu tiên. Một ca tham chiếu nhỏ giúp so sánh khi đổi thư viện hoặc mô hình. Đừng lưu khóa hay toàn bộ dữ liệu khách hàng. Khi nhờ hỗ trợ, cấu trúc yêu cầu tối thiểu, mã yêu cầu và lỗi đã ẩn thông tin riêng tư hữu ích hơn toàn bộ nhật ký production.