Gemini Generate Content

Создавайте текстовые и мультимодальные ответы, вызовы инструментов и результаты выполнения кода с Gemini Content и Parts.

API Generate Content использует Content и Parts для запросов с текстом, мультимодальным вводом, вызовами функций и выполнением кода. Результаты возвращаются через Candidates, Usage Metadata и сведения о безопасности. Запросы используют Bearer-ключ API; поддерживаемые модальности ввода, инструменты и расширенные параметры генерации зависят от модели. Ориентируйтесь на модели, доступные текущему аккаунту, и официальное описание возможностей.

POST/v1beta/models/{model}:generateContent

Генерируйте ответы с текстом, мультимодальным содержимым, вызовами функций или выполнением кода с помощью Gemini Content и Parts.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Параметры пути

model*string

ID модели для генерации. Путь автоматически формируется как models/{model}.

По умолчанию"MODEL_ID"

Тело запроса

Gemini использует Content и Parts для текста, мультимодального ввода, инструментов и настроек генерации.

application/json

Текстовый диалог

Используйте Content user и model для одноходового или многоходового текстового диалога.

contents[]: Содержимое диалога по порядку.
parts[].text: Текст каждого сообщения.
role: Автор сообщения, обычно user или model.

application/json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Здравствуйте! Представьтесь, пожалуйста."
        }
      ]
    }
  ]
}

Используйте Content и text Part для одноходового или многоходового текстового диалога.

contents*array<>

Текстовые Content по порядку. Каждое сообщение передаёт содержимое через parts[].text.

Элементы1 <= items

tools?array<>

Функции, выполнение кода, поиск, URL Context, File Search, MCP и другие инструменты, доступные модели.

toolConfig?

Настройки вызова инструментов в запросе.

safetySettings?array<>

Пороги блокировки содержимого по категориям безопасности.

systemInstruction?

Системные инструкции разработчика; сейчас поддерживается только текстовое содержимое.

generationConfig?

Настройки генерации и вывода модели.

cachedContent?string

Имя кэшированного содержимого для контекста в формате cachedContents/{cachedContent}.

serviceTier?ServiceTier

Уровень обслуживания запроса.

Допустимые значения

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

store?boolean

Управляет журналированием текущего запроса; при задании имеет приоритет над настройками проекта.

Тело ответа

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "Здравствуйте! Представьтесь, пожалуйста."          }        ]      }    ]  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Здравствуйте! Я — ИИ-помощник, который может отвечать на вопросы и помогать выполнять задачи."
          }
        ],
        "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"
}

Официальная документация Google Gemini Generate ContentОпределение протокола поставщика и последние изменения полей.

Аутентификация

Параметры пути

Тело запроса

Тело ответа

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`