Генерирует ответ модели с учетом входного сообщения.
HTTP-запрос
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateText
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
model | Необходимый. Имя |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "prompt": { object ( |
Поля | |
---|---|
prompt | Необходимый. Входной текст в произвольной форме, передаваемый модели в виде подсказки. При наличии подсказки модель сгенерирует ответ TextCompletion, который прогнозируется как завершение входного текста. |
safetySettings[] | Необязательный. Список уникальных экземпляров это будет применяться к |
stopSequences[] | Набор последовательностей символов (до 5), которые останавливают генерацию вывода. Если указано, API остановится при первом появлении последовательности остановки. Последовательность остановки не будет включена в ответ. |
temperature | Необязательный. Управляет случайностью вывода. Примечание. Значение по умолчанию зависит от модели. См. атрибут Значения могут находиться в диапазоне от [0,0,1,0] включительно. Значение ближе к 1,0 приведет к более разнообразным и творческим ответам, тогда как значение ближе к 0,0 обычно приводит к более прямым ответам модели. |
candidateCount | Необязательный. Количество сгенерированных ответов для возврата. Это значение должно находиться в диапазоне [1, 8] включительно. Если не установлено, по умолчанию будет 1. |
maxOutputTokens | Необязательный. Максимальное количество токенов, которые можно включить в кандидата. Если значение не установлено, по умолчанию будет установлено значение outputTokenLimit, указанное в спецификации |
topP | Необязательный. Максимальная совокупная вероятность токенов, которую следует учитывать при выборке. Модель использует комбинированную выборку Top-k и ядра. Токены сортируются на основе присвоенных им вероятностей, поэтому учитываются только наиболее вероятные токены. Выборка Top-k напрямую ограничивает максимальное количество рассматриваемых токенов, тогда как выборка Nucleus ограничивает количество токенов на основе кумулятивной вероятности. Примечание. Значение по умолчанию зависит от модели. См. атрибут |
topK | Необязательный. Максимальное количество токенов, которые следует учитывать при выборке. Модель использует комбинированную выборку Top-k и ядра. Выборка Top-k рассматривает набор наиболее вероятных токенов Примечание. Значение по умолчанию зависит от модели. См. атрибут |
Тело ответа
В случае успеха тело ответа содержит экземпляр GenerateTextResponse
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
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
Для получения дополнительной информации см. Обзор аутентификации .