Xác thực
Lấy Base URL ở đâu và mỗi giao thức xác thực thế nào — Bearer, x-api-key, x-goog-api-key.
Mỗi lệnh gọi cần hai thứ: một khóa API (chứng minh bạn là ai) và Base URL (yêu cầu đi tới đâu). Cả hai đều có trong bảng điều khiển.
Lấy Base URL
Đăng nhập bảng điều khiển và mở hộp thoại "Bắt đầu nhanh" trên bất kỳ thẻ mô hình nào (hoặc từ phần tổng quan tài khoản). Chọn giao thức của bạn trong danh sách thả xuống và sao chép Base URL tương ứng.
- Tiền tố đường dẫn khác nhau giữa các giao thức — luôn sao chép từ hộp thoại;
- Các ví dụ trong tài liệu viết
https://<your-base-url>; hãy thay bằng địa chỉ thực tế của bạn.
Xác thực theo từng giao thức
| Giao thức | Header xác thực | Ghi chú |
|---|---|---|
| Tương thích OpenAI | Authorization: Bearer YOUR_API_KEY | Hoạt động với SDK OpenAI chính thức — đặt api_key + base_url |
| Anthropic | x-api-key: YOUR_API_KEY + anthropic-version: 2023-06-01 | Header phiên bản là bắt buộc; SDK tự động gửi nó |
| Gemini | x-goog-api-key: YOUR_API_KEY | Model ID nằm trực tiếp trong đường dẫn URL |
Lỗi xác thực thường gặp
- 401 Unauthorized: khóa sai, đã bị xóa hoặc đã hết hạn. Kiểm tra rằng bạn đang dùng khóa đầy đủ đã lưu lúc tạo, không có khoảng trắng hay dòng trống thừa.
- Lộ khóa trong mã frontend: mọi thứ trong mã chạy trên trình duyệt đều ai cũng thấy — khóa phải nằm trên máy chủ của bạn hoặc trong biến môi trường cục bộ.
- Nhầm khóa: mỗi khóa có hạn mức chi tiêu riêng; hãy chắc rằng bạn đang dùng đúng khóa cho đúng môi trường (production / kiểm thử).
Về việc tạo và cất giữ khóa, xem Tạo khóa API.