Lấy khoá API Gemini

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

Lấy khoá Gemini API trong Google AI Studio

Thiết lập khoá API

Để kiểm thử ban đầu, bạn có thể mã hoá cứng khoá API, nhưng việc này chỉ nên là tạm thời vì không an toàn. Phần còn lại của phần này sẽ trình bày cách thiết lập khoá API trên máy cục bộ dưới dạng biến môi trường với nhiều hệ điều hành.

Linux/macOS – Bash

Bash là một cấu hình thiết bị đầu cuối phổ biến trên Linux và macOS. Bạn có thể kiểm tra xem mình có tệp cấu hình cho ứng dụng đó hay không bằng cách chạy lệnh sau:

~/.bashrc

Nếu phản hồi là "Không có tệp hoặc thư mục nào như vậy", bạn cần tạo tệp này và mở tệp bằng cách chạy các lệnh sau hoặc sử dụng zsh:

touch ~/.bashrc
open ~/.bashrc

Tiếp theo, bạn cần đặt khoá API bằng cách thêm lệnh xuất sau:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Sau khi lưu tệp, hãy áp dụng các thay đổi bằng cách chạy:

source ~/.bashrc

macOS – Zsh

Zsh là một cấu hình dòng lệnh phổ biến trên Linux và macOS. Bạn có thể kiểm tra xem mình có tệp cấu hình cho ứng dụng đó hay không bằng cách chạy lệnh sau:

~/.zshrc

Nếu phản hồi là "Không có tệp hoặc thư mục nào như vậy", bạn cần tạo tệp này và mở tệp bằng cách chạy các lệnh sau hoặc sử dụng bash:

touch ~/.zshrc
open ~/.zshrc

Tiếp theo, bạn cần đặt khoá API bằng cách thêm lệnh xuất sau:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Sau khi lưu tệp, hãy áp dụng các thay đổi bằng cách chạy:

source ~/.zshrc

Windows

  1. Tìm "Biến môi trường" trong phần cài đặt hệ thống
  2. Chỉnh sửa "Biến người dùng" (dành cho người dùng hiện tại) hoặc "Biến hệ thống" (dành cho tất cả người dùng – hãy sử dụng cẩn thận).
  3. Tạo biến và thêm export GEMINI_API_KEY=your_key_here
  4. Áp dụng các thay đổi

Gửi yêu cầu Gemini API đầu tiên

Bạn có thể sử dụng lệnh curl để xác minh chế độ thiết lập:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Bảo mật khoá API

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

  • API Gemini của Google AI sử dụng khoá API để uỷ quyền. Nếu người khác có quyền truy cập vào khoá API Gemini của bạn, họ có thể thực hiện lệnh gọi bằng hạn mức của dự án, điều này có thể dẫn đến việc mất hạn mức hoặc tính thêm phí cho các dự án được tính phí, ngoài việc truy cập vào các mô hình và tệp đã điều chỉnh.

  • Việc thêm các quy tắc hạn chế đối với khoá API có thể giúp giới hạn phạm vi sử dụng thông qua mỗi khoá API.

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

    • ĐỪNG kiểm tra khoá Gemini API vào hệ thống quản lý nguồn.
    • Các ứng dụng phía máy khách (Android, Swift, web và Dart/Flutter) có nguy cơ làm lộ khoá API. Bạn không nên sử dụng SDK ứng dụng Google AI trong các ứng dụng chính thức để gọi API Gemini của Google AI trực tiếp từ ứng dụng web và ứng dụng di động.

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