Gemini Generate Content

Tạo phản hồi văn bản, đa phương thức, công cụ và thực thi mã bằng cấu trúc Gemini Content và Parts.

API Generate Content sử dụng Content và Parts để biểu diễn yêu cầu văn bản, đa phương thức, gọi hàm và thực thi mã; trả về kết quả tạo nội dung qua Candidates, Usage Metadata và thông tin an toàn. Yêu cầu xác thực bằng Bearer API Key. Các phương thức đầu vào, công cụ và tham số tạo nội dung nâng cao có thể khác nhau giữa các mô hình; căn cứ vào mô hình khả dụng cho tài khoản hiện tại và mô tả khả năng chính thức.

POST/v1beta/models/{model}:generateContent

Tạo phản hồi văn bản, đa phương thức, gọi hàm hoặc thực thi mã bằng cấu trúc Gemini Content và Parts.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Tham số đường dẫn

model*string

ID mô hình dùng để tạo nội dung. Đường dẫn tự động có dạng models/{model}.

Giá trị mặc định"MODEL_ID"

Nội dung yêu cầu

Gemini biểu diễn văn bản, đa phương thức, công cụ và cấu hình tạo nội dung bằng Content và Parts.

application/json

Hội thoại văn bản

Dùng Content với vai trò user và model để tổ chức hội thoại văn bản một hoặc nhiều lượt.

contents[]: Nội dung hội thoại theo thứ tự.
parts[].text: Nội dung văn bản trong mỗi tin nhắn.
role: Bên tạo tin nhắn, giá trị thường dùng là user hoặc model.

application/json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Xin chào! Hãy giới thiệu bản thân."
        }
      ]
    }
  ]
}

Dùng Content và text Part để tổ chức hội thoại văn bản một hoặc nhiều lượt.

contents*array<>

Các Content văn bản theo thứ tự. Mỗi tin nhắn cung cấp nội dung qua parts[].text.

Số phần tử1 <= items

tools?array<>

Các công cụ mô hình có thể dùng, như hàm, thực thi mã, tìm kiếm, URL Context, File Search và MCP.

toolConfig?

Cấu hình gọi công cụ trong yêu cầu.

safetySettings?array<>

Cấu hình ngưỡng chặn nội dung theo loại an toàn.

systemInstruction?

Chỉ dẫn hệ thống do nhà phát triển đặt; hiện chỉ hỗ trợ nội dung văn bản.

generationConfig?

Cấu hình tạo nội dung và đầu ra của mô hình.

cachedContent?string

Tên nội dung đã lưu đệm dùng làm ngữ cảnh, có dạng cachedContents/{cachedContent}.

serviceTier?ServiceTier

Cấp dịch vụ sử dụng cho yêu cầu.

Giá trị được phép

"unspecified"
"standard"
"flex"
"priority"

store?boolean

Điều khiển hành vi ghi log của yêu cầu hiện tại; khi được đặt, ưu tiên hơn cấu hình log cấp dự án.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "Xin chào! Hãy giới thiệu bản thân."          }        ]      }    ]  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Xin chào! Tôi là một trợ lý AI có thể giúp bạn giải đáp thắc mắc và hoàn thành công việc."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        }
      ],
      "tokenCount": 24
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "HARM_CATEGORY_HARASSMENT",
        "probability": "NEGLIGIBLE"
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 24,
    "totalTokenCount": 32,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 8
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 24
      }
    ]
  },
  "modelVersion": "MODEL_ID",
  "responseId": "response-example"
}

Tài liệu chính thức Google Gemini Generate ContentXem định nghĩa giao thức phía nhà cung cấp và các thay đổi trường mới nhất.

Xác thực

Tham số đường dẫn

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

403application/json

404application/json

413application/json

429application/json

500application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`