- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
Genera una respuesta del modelo cuando recibe un mensaje de entrada.
Solicitud HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateText
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
model |
Obligatorio. Es el nombre de |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "prompt": { object ( |
Campos | |
---|---|
prompt |
Obligatorio. El texto de entrada de formato libre dado al modelo como una instrucción. Cuando se recibe una instrucción, el modelo generará una respuesta TextCompletion que predice como la finalización del texto de entrada. |
safetySettings[] |
Opcional. Una lista de instancias de que se aplicará en |
stopSequences[] |
El conjunto de secuencias de caracteres (hasta 5) que detendrán la generación del resultado. Si se especifica, la API se detendrá en la primera aparición de una secuencia de detención. La secuencia de detención no se incluirá como parte de la respuesta. |
temperature |
Opcional. Controla la aleatoriedad del resultado. Nota: El valor predeterminado varía según el modelo. Consulta el atributo Los valores pueden variar de [0.0,1.0] inclusive. Un valor más cercano a 1.0 producirá respuestas más variadas y creativas, mientras que un valor cercano a 0.0 generalmente dará como resultado respuestas más sencillas por parte del modelo. |
candidateCount |
Opcional. Cantidad de respuestas generadas que se mostrarán. Este valor debe estar entre [1, 8] inclusive. Si no la estableces, el valor predeterminado será 1. |
maxOutputTokens |
Opcional. La cantidad máxima de tokens que se deben incluir en un candidato. Si no se configura, se usará de forma predeterminada como outputTokenLimit especificado en la especificación |
topP |
Opcional. Es la probabilidad acumulada máxima de los tokens que se deben tener en cuenta cuando se realiza el muestreo. El modelo usa el muestreo combinado de k superior y núcleo. Los tokens se ordenan según las probabilidades asignadas de modo que solo se consideren los más probables. El muestreo de k superior limita directamente la cantidad máxima de tokens a considerar, mientras que el muestreo de Nucleus limita la cantidad de tokens según la probabilidad acumulativa. Nota: El valor predeterminado varía según el modelo. Consulta el atributo |
topK |
Opcional. Es la cantidad máxima de tokens que se deben tener en cuenta cuando se realiza el muestreo. El modelo usa el muestreo combinado de k superior y núcleo. El muestreo de k superior considera el conjunto de tokens más probables de Nota: El valor predeterminado varía según el modelo. Consulta el atributo |
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de GenerateTextResponse
.
Permisos de autorización
Se necesita uno de los siguientes alcances de 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
Para obtener más información, consulta Descripción general de la autenticación.