- 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 según una GenerateContentRequest
de entrada.
Las capacidades de entrada difieren entre los modelos, incluidos los ajustados. Consulta la guía del modelo y la guía de ajuste para obtener más detalles.
Solicitud HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateContent
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
model |
Obligatorio. Es el nombre de Formato: |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "contents": [ { object ( |
Campos | |
---|---|
contents[] |
Obligatorio. El contenido de la conversación actual con el modelo. Para consultas de un solo turno, esta es una instancia única. Para consultas de varios turnos, es un campo repetido que contiene el historial de conversaciones y la solicitud más reciente. |
tools[] |
Opcional. Una lista de Un |
toolConfig |
Opcional. Configuración de herramientas para cualquier |
safetySettings[] |
Opcional. Una lista de instancias de Esto se aplicará de manera forzosa en |
systemInstruction |
Opcional. Instrucción del sistema establecida por el desarrollador. Actualmente, es solo texto. |
generationConfig |
Opcional. Opciones de configuración para la generación y la salida de modelos. |
cachedContent |
Opcional. Es el nombre del contenido almacenado en caché que se usa como contexto para entregar la predicción. Nota: Solo se usa en el almacenamiento en caché explícito, donde los usuarios pueden tener control sobre el almacenamiento en caché (p.ej., qué contenido almacenar en caché) y disfrutar de ahorros de costos garantizados. Formato: |
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de GenerateContentResponse
.
Alcances de autorización
Se necesita uno de los siguientes permisos 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.