Tất cả hướng dẫn
HƯỚNG DẪN AI

Cấu hình và bảo vệ API key

Hướng dẫn AI
Chìa khóa và tấm khiên tượng trưng cho việc bảo vệ API key.

API key cấp quyền gọi dịch vụ. Chỉ cấu hình bằng địa chỉ, hướng dẫn và quyền truy cập được cung cấp cho gói thực tế của bạn.

Lưu key phía server

Dùng biến môi trường hoặc kho secret của nền tảng triển khai. Không đặt key trong JavaScript chạy trên trình duyệt, URL, ảnh chụp hay repository. Với ứng dụng desktop, dùng nơi lưu credential mà công cụ hỗ trợ.

# Mẫu tên biến, không phải credential hoạt động
AI_BASE_URL=<dia-chi-do-nha-cung-cap-xac-nhan>
AI_API_KEY=<key-cua-ban>

Đối chiếu endpoint và model

Không suy ra dashboard, đường dẫn /v1 hay tên model từ tên miền API. Kiểm tra tài liệu được bàn giao. Nếu công cụ yêu cầu một định dạng API cụ thể, xác nhận khả năng tương thích trước khi dùng.

Thử một yêu cầu có kiểm soát

Dùng nội dung không nhạy cảm và giới hạn đầu ra phù hợp. Kiểm tra quota, chi phí và lỗi trả về trong dashboard thực tế. Yêu cầu thử có thể tính phí theo chính sách của gói; không giả định có sandbox.

Khi key bị lộ hoặc gặp lỗi

Thu hồi hoặc thay key trong hệ thống quản lý được cung cấp. Khi cần hỗ trợ, gửi mã lỗi, thời điểm và tên công cụ; che key và dữ liệu cá nhân. Không gửi mật khẩu hoặc mã OTP qua form liên hệ.