La API de Gemini admite la carga de archivos multimedia por separado de la entrada de instrucciones, lo que permite que tu contenido multimedia se vuelva a usar en varias solicitudes y varias instrucciones. Para obtener más detalles, consulta la guía Cómo usar instrucciones con contenido multimedia.
Método: media.upload
Crea un File
.
Extremo
- URI de carga para las solicitudes de carga de medios:
- URI de metadatos para las solicitudes de metadatos únicamente:
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
file
object (File
)
Opcional. Son los metadatos del archivo que se creará.
Ejemplo de solicitud
Imagen
Python
Node.js
Go
Una caracola
Audio
Python
Node.js
Go
Una caracola
Texto
Python
Node.js
Go
Una caracola
Video
Python
Node.js
Go
Una caracola
Python
Método: files.get
Obtiene los metadatos del File
determinado.
Extremo
obtener https://generativelanguage.googleapis.com/v1beta/{name=files/*}Parámetros de ruta
name
string
Obligatorio. Es el nombre del File
que se debe obtener. Ejemplo: files/abc-123
Toma la forma files/{file}
.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Ejemplo de solicitud
Python
Node.js
Go
Una caracola
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de File
.
Método: files.list
Muestra una lista de los metadatos de los File
que pertenecen al proyecto solicitante.
Extremo
obtener https://generativelanguage.googleapis.com/v1beta/filesParámetros de consulta
pageSize
integer
Opcional. Cantidad máxima de File
que se mostrarán por página. Si no se especifica, el valor predeterminado es 10. El pageSize
máximo es 100.
pageToken
string
Opcional. Un token de página de una llamada files.list
anterior.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Ejemplo de solicitud
Python
Node.js
Go
Una caracola
Cuerpo de la respuesta
La respuesta para files.list
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
files[]
object (File
)
La lista de File
.
nextPageToken
string
Un token que se puede enviar como pageToken
a una llamada files.list
posterior.
Representación JSON |
---|
{
"files": [
{
object ( |
Método: files.delete
Borra el File
.
Extremo
delete https://generativelanguage.googleapis.com/v1beta/{name=files/*}Parámetros de ruta
name
string
Obligatorio. El nombre de la File
que se borrará. Ejemplo: files/abc-123
Tiene el formato files/{file}
.
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Ejemplo de solicitud
Python
Node.js
Go
Una caracola
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
Recurso de REST: files
Recurso: Archivo
Un archivo subido a la API.
name
string
Inmutable. Identificador. Nombre del recurso de File
. El ID (nombre sin el prefijo “files/”) puede contener hasta 40 caracteres alfanuméricos en minúscula o guiones (-). El ID no puede comenzar ni terminar con un guion. Si el nombre está vacío en el momento de la creación, se generará uno único. Ejemplo: files/123-456
displayName
string
Opcional. Es el nombre visible legible por humanos de File
. El nombre visible no debe tener más de 512 caracteres, incluidos los espacios. Ejemplo: "Imagen de bienvenida"
mimeType
string
Solo salida. Es el tipo de MIME del archivo.
sizeBytes
string (int64 format)
Solo salida. Tamaño del archivo expresado en bytes.
createTime
string (Timestamp
format)
Solo salida. Es la marca de tiempo de la creación del File
.
Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z"
y "2014-10-02T15:01:23.045123456Z"
.
updateTime
string (Timestamp
format)
Solo salida. La marca de tiempo de la última vez que se actualizó File
.
Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z"
y "2014-10-02T15:01:23.045123456Z"
.
expirationTime
string (Timestamp
format)
Solo salida. Es la marca de tiempo del momento en que se borrará el File
. Solo se establece si el File
está programado para vencer.
Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z"
y "2014-10-02T15:01:23.045123456Z"
.
sha256Hash
string (bytes format)
Solo salida. Hash SHA-256 de los bytes subidos.
String codificada en base64.
uri
string
Solo salida. Es el URI de File
.
state
enum (State
)
Solo salida. Es el estado de procesamiento del archivo.
error
object (Status
)
Solo salida. Es el estado de error si el procesamiento del archivo falló.
metadata
. Metadatos del archivo Las direcciones (metadata
) solo pueden ser una de las siguientes opciones:
videoMetadata
object (VideoMetadata
)
Solo salida. Metadatos de un video.
Representación JSON |
---|
{ "name": string, "displayName": string, "mimeType": string, "sizeBytes": string, "createTime": string, "updateTime": string, "expirationTime": string, "sha256Hash": string, "uri": string, "state": enum ( |
VideoMetadata
Metadatos de un video File
.
videoDuration
string (Duration
format)
Es la duración del video.
Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s
”. Ejemplo: "3.5s"
.
Representación JSON |
---|
{ "videoDuration": string } |
Estado
Estados del ciclo de vida de un archivo.
Enumeraciones | |
---|---|
STATE_UNSPECIFIED |
Es el valor predeterminado. Este valor se usa si se omite el estado. |
PROCESSING |
El archivo se está procesando y aún no se puede usar para la inferencia. |
ACTIVE |
El archivo se procesa y está disponible para inferencia. |
FAILED |
No se pudo procesar el archivo. |
Estado
El tipo de Status
define un modelo de error lógico que es adecuado para entornos de programación diferentes, incluidas las API de REST y las API de RPC. Lo usa gRPC. Cada mensaje Status
contiene tres datos: código de error, mensaje de error y detalles del error.
Puedes obtener más información sobre este modelo de error y cómo trabajar con él en la guía de diseño de API.
code
integer
El código de estado, que debe ser un valor enum de google.rpc.Code
.
message
string
Un mensaje de error dirigido al desarrollador, que debe estar en inglés. Cualquier mensaje de error dirigido al usuario debe localizarse y enviarse al campo google.rpc.Status.details
; o el cliente debe localizarlo.
details[]
object
Una lista de mensajes que contienen los detalles del error. Hay un conjunto común de tipos de mensajes para que usen las API.
Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type"
contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }
.
Representación JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |