Method: models.streamGenerateContent

Tạo phản hồi được phát trực tuyến từ mô hình khi có đầu vào GenerateContentRequest.

Yêu cầu HTTP

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:streamGenerateContent

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
model

string

Bắt buộc. Tên của Model dùng để tạo lượt hoàn tất.

Định dạng: name=models/{model}.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
Các trường
contents[]

object (Content)

Bắt buộc. Nội dung của cuộc trò chuyện hiện tại với mô hình.

Đối với truy vấn một lượt, đây là một trường hợp. Đối với truy vấn nhiều lượt, đây là trường lặp lại, chứa nhật ký trò chuyện và yêu cầu mới nhất.

safetySettings[]

object (SafetySetting)

Không bắt buộc. Danh sách phiên bản SafetySetting riêng biệt để chặn nội dung không an toàn.

Yêu cầu này sẽ được thực thi trên GenerateContentRequest.contentsGenerateContentResponse.candidates. Không được có nhiều chế độ cài đặt cho mỗi loại SafetyCategory. API sẽ chặn mọi nội dung và phản hồi không đáp ứng ngưỡng do các chế độ cài đặt này đặt ra. Danh sách này ghi đè các chế độ cài đặt mặc định cho mỗi SafetyCategory được chỉ định trong safetySettings. Nếu không có SafetySetting cho một SafetyCategory nhất định được cung cấp trong danh sách, thì API sẽ sử dụng chế độ cài đặt an toàn mặc định cho danh mục đó. Các danh mục gây hại HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT được hỗ trợ.

generationConfig

object (GenerationConfig)

Không bắt buộc. Các tuỳ chọn cấu hình để tạo mô hình và đầu ra.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một luồng gồm các thực thể GenerateContentResponse.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

Để biết thêm thông tin, hãy xem bài viết Tổng quan về xác thực.