Nhận khoá API

Để sử dụng Gemini API, bạn cần có khoá API. Bạn có thể tạo khoá chỉ bằng một cú nhấp chuột trong Google AI Studio.

Tải khoá API

Xác minh khoá API bằng lệnh curl

Bạn có thể dùng lệnh curl để xác minh chế độ thiết lập của mình. Bạn có thể chuyển khoá API trong URL:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Hoặc trong tiêu đề x-goog-api-key:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

Bảo mật khoá API của bạn

Bạn cần phải bảo mật khoá Gemini API của mình. Sau đây là một vài điểm cần lưu ý khi sử dụng khoá Gemini API:

  • Gemini API của Google sử dụng khoá API để uỷ quyền. Nếu người khác có quyền truy cập với khoá Gemini API, họ có thể gọi điện bằng hạn mức của dự án, điều này có thể dẫn đến mất hạn mức hoặc các khoản phí thanh toán bổ sung (nếu thanh toán là bật). Khoá API cũng bảo vệ quyền truy cập vào các mô hình và tệp được điều chỉnh.

  • Khi nhấp vào Lấy khoá API trong Google AI Studio, bạn có thể chọn xem cung cấp khoá Gemini API trong một dự án mới hoặc hiện có trên Google Cloud. Chiến lược phát hành đĩa đơn Danh sách khoá API trong Google AI Studio hiển thị tất cả các khoá API mà AI Studio đã cấp phép để sử dụng với AI Gemini API (cùng với tất cả dự án liên kết trên Google Cloud).

    • Tuy nhiên, mọi khoá API trong dự án trên Google Cloud có thể bị dùng để gọi Google AI Gemini API. Bạn có thể xem và quản lý tất cả các khoá API của dự án trong API và Dịch vụ > Bảng thông tin đăng nhập trong bảng điều khiển Google Cloud.

  • Đang thêm Các hạn chế đối với khoá API có thể giúp giới hạn diện tích bề mặt có thể sử dụng thông qua mỗi khoá API. Theo mặc định, Khoá API Gemini do Google AI Studio tạo chỉ có thể dùng với AI của Google Gemini API (tên chính thức là "Generative Language API" hoặc generativelanguage.googleapis.com).

    • Trường hợp dự án của bạn trên Google Cloud có khoá API nào thiếu API hoặc bất kỳ khoá API nào có trong danh sách cho phép sử dụng Ngôn ngữ tạo sinh thì bạn có thể sử dụng các khoá đó với Gemini AI của Google. Tốt nhất thực hành hạn chế mỗi khoá API chỉ cho những API mà bạn gọi bằng cách sử dụng khoá đó .
    • Xin lưu ý rằng ngay cả khi có các hạn chế về khoá API, nếu một đối tượng xấu lấy được Khoá API của bạn. Người dùng có thể sử dụng khoá đó để thực hiện cuộc gọi bằng hạn mức của dự án cho tất cả các API được đưa vào danh sách cho phép cho khoá API đó.

  • Bạn có trách nhiệm bảo mật khoá Gemini API của mình.

    • KHÔNG kiểm tra khoá Gemini API ở chế độ kiểm soát nguồn.
    • Rủi ro đối với các ứng dụng phía máy khách (Android, Swift, web và Dart/Flutter) để lộ khoá API, vì vậy, bạn không nên sử dụng SDK ứng dụng AI của Google trong các ứng dụng chính thức để gọi API Gemini AI của Google trực tiếp từ trên thiết bị di động và web. Hãy xem phần Bắt đầu nhanh về SDK để tìm hiểu các phương pháp hay nhất theo từng ngôn ngữ để bảo mật khoá API của bạn.

Để tìm hiểu một số phương pháp chung hay nhất, bạn cũng có thể tham khảo bài viết hỗ trợ này.

Các bước tiếp theo

  • Hãy tham khảo nội dung bắt đầu nhanh về API để tìm hiểu các phương pháp hay nhất để bảo mật và sử dụng khoá API đó.