Tạo và bảo vệ khoá API
Dùng khoá riêng có giới hạn quyền và ngân sách ngày cho từng client cục bộ.
Trước khi bắt đầu
- Mở Cài đặt → API & agent trong app Windows.
Các bước
Tạo khoá dễ nhận biết
Trong “Khoá API”, chọn “Tạo khoá”. Đặt tên riêng cho từng ứng dụng để nhận biết và thu hồi độc lập. Khoá gồm
fsk_và 32 chữ cái hoặc chữ số; app lưu mã băm SHA-256, không lưu toàn bộ bí mật.Chỉ chọn quyền cần thiết
read: trạng thái, model, đọc việc và tải kết quả.generate: tải tham chiếu, tạo và huỷ việc.characters: tạo và sửa nhân vật.
Chỉ đọc được việc và tệp thuộc khoá; nhân vật dùng chung trong app. Quy trình tạo có theo dõi kết quả cần thêm
read.Đặt ngân sách ngày
Chọn trần credit là số nguyên từ 0 đến 100.000. 0 là không đặt trần, không phải cấm tiêu credit. Khi nhận việc, app tính credit đã gửi hôm nay cùng ước tính đang giữ cho việc chờ/đang chạy, nên chỉ nhìn số đã dùng có thể chưa giải thích được việc bị từ chối. Xem credit và chi phí.
Lưu bí mật một lần rồi xác thực
Chép đầy đủ khoá trước khi đóng hộp thoại hiển thị. Danh sách sau đó chỉ còn tiền tố che bớt. Dùng khoá trong header Authorization, không đưa vào URL hoặc kho mã công khai. Thử
GET /v1/statusvớiAuthorization: Bearer <your local API key>.Thu hồi thay vì chia sẻ hay khôi phục
Chọn “Thu hồi” khi mất hoặc lộ khoá, rồi tạo khoá thay thế và cập nhật client. Khoá đã thu hồi không còn được chấp nhận. Khoá mới không tự truy cập được việc thuộc khoá cũ.
Khi đã xong
Khoá xuất hiện với đúng quyền và trần, và lệnh đọc trạng thái có xác thực thành công.
Nếu gặp trục trặc
Có xem lại toàn bộ khoá được không?
Không. Tạo khoá thay thế rồi thu hồi khoá đã mất.
Vì sao gặp 401 hoặc 403?
401 là thiếu khoá, khoá sai hoặc đã thu hồi. 403 forbidden là thiếu quyền cần thiết; tạo khoá có quyền phù hợp. Yêu cầu có Origin cũng bị từ chối theo cơ chế riêng.