- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
Genera una respuesta en transmisión a partir del modelo según una GenerateContentRequest
de entrada.
Solicitud HTTP
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:streamGenerateContent
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 correctamente, el cuerpo de la respuesta contiene un flujo de instancias de GenerateContentResponse
.
Permisos 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.