Method: models.generateContent

Tạo phản hồi từ mô hình khi có dữ liệu đầu vào GenerateContentRequest.

Khả năng đầu vào khác nhau giữa các mô hình, bao gồm cả các mô hình đã được điều chỉnh. Xem hướng dẫn về mẫu thiết bịhướng dẫn điều chỉnh để biết thông tin chi tiết.

Yêu cầu HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateContent

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

Tham số đường dẫn

Thông số
model

string

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

Đị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)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  },
  "cachedContent": string
}
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 chỉ là một phiên bản. Đối với truy vấn nhiều lượt, đây là trường lặp lại có chứa nhật ký trò chuyện và yêu cầu mới nhất.

tools[]

object (Tool)

Không bắt buộc. Danh sách Tools mà mô hình có thể dùng để tạo phản hồi tiếp theo.

Tool là một đoạn mã cho phép hệ thống tương tác với các hệ thống bên ngoài để thực hiện một hành động hoặc một tập hợp hành động, nằm ngoài phạm vi kiến thức và phạm vi của mô hình. Công cụ duy nhất được hỗ trợ hiện tại là Function.

toolConfig

object (ToolConfig)

Không bắt buộc. Cấu hình công cụ cho mọi Tool được chỉ định trong yêu cầu.

safetySettings[]

object (SafetySetting)

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

Thay đổi này sẽ được thực thi trên GenerateContentRequest.contentsGenerateContentResponse.candidates. Không được có nhiều hơn một chế độ cài đặt cho mỗi loại SafetyCategory. API này 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 từng SafetyCategory được chỉ định trong phần safetySettings. Nếu không có SafetySetting cho một SafetyCategory nhất định được cung cấp trong danh sách, 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ợ.

systemInstruction

object (Content)

Không bắt buộc. Hướng dẫn hệ thống thiết lập dành cho nhà phát triển. Hiện tại, chỉ có văn bản.

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.

cachedContent

string

Không bắt buộc. Tên của nội dung được lưu trong bộ nhớ đệm được dùng làm ngữ cảnh để cung cấp thông tin dự đoán. Lưu ý: chỉ được sử dụng trong bộ nhớ đệm rõ ràng, trong đó người dùng có thể kiểm soát việc lưu vào bộ nhớ đệm (ví dụ: nội dung nào cần lưu vào bộ nhớ đệm) và được đảm bảo tiết kiệm chi phí. Định dạng cachedContents/{cachedContent}

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 phiên bản của 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ề việc xác thực.