Giao thức Gemini

Gửi nội dung theo định dạng Gemini generateContent.

Địa chỉ dịch vụ

Trang này bao phủ REST Gemini native cho danh sách mô hình, tạo nội dung, streaming và embedding. Tham số hình ảnh nằm trong hướng dẫn hình ảnh Gemini native.

Mô hình và khám phá

Mục đích	Phương thức	Đường dẫn
Danh sách mô hình Gemini	GET	/v1beta/models
Danh sách mô hình tương thích Gemini	GET	/v1/models

Tạo nội dung

Mục đích	Phương thức	Đường dẫn
generateContent	POST	/v1beta/models/{model}:generateContent
streamGenerateContent	POST	/v1beta/models/{model}:streamGenerateContent

Embedding

Mục đích	Phương thức	Đường dẫn
embedContent	POST	/v1beta/models/{model}:embedContent
batchEmbedContents	POST	/v1beta/models/{model}:batchEmbedContents
Embedding tương thích Gemini	POST	/v1/engines/{model}/embeddings

Yêu cầu tối thiểu

Thay YOUR_MODEL bằng model ID thật và giữ nó trong đường dẫn URL. Ưu tiên x-goog-api-key: YOUR_API_KEY; gateway cũng chấp nhận Bearer. Chỉ dùng tham số truy vấn key khi ứng dụng yêu cầu, vì URL có thể bị ghi log.

curl "https://api.popgo.site/v1beta/models/YOUR_MODEL:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "Hãy xác nhận kết nối"}]}
    ]
  }'

Kiểm tra

Phản hồi thành công có candidate hoặc embedding. Dùng streamGenerateContent cho streaming; chọn embedContent, batchEmbedContents hoặc đường dẫn tương thích cho embedding. Với 404, kiểm tra model ID, đường dẫn giao thức và nhóm Key.