Mit der Gemini API können Mediendateien getrennt von den Prompt-Eingaben hochgeladen werden. So können deine Medien für mehrere Anfragen und mehrere Prompts wiederverwendet werden. Weitere Informationen finden Sie im Leitfaden Prompts mit Medien.
Methode: media.upload
- Endpunkt
- Anfragetext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Antworttext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Beispielanfrage <ph type="x-smartling-placeholder">
Erstellt einen File
.
Endpunkt
- Upload-URI für Anfragen zum Hochladen von Medien:
https://generativelanguage.googleapis.com/upload/v1beta/files
.
- Metadaten-URI für Anfragen, die nur Metadaten enthalten:
https://generativelanguage.googleapis.com/v1beta/files
.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
<ph type="x-smartling-placeholder">file
object (File
)
Optional. Metadaten für die zu erstellende Datei.
Beispielanfrage
Bild
Python
Node.js
Ok
Muschel
Audio
Python
Node.js
Ok
Muschel
Text
Python
Node.js
Ok
Muschel
Video
Python
Node.js
Ok
Muschel
Python
Methode: files.get
- Endpunkt
- Pfadparameter
- Anfragetext
- Antworttext
- Beispielanfrage
<ph type="x-smartling-placeholder">
- </ph>
- Basic
Ruft die Metadaten für die angegebene File
ab.
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> erhalten
https://generativelanguage.googleapis.com/v1beta/{name=files/*}
.
Pfadparameter
name
string
Erforderlich. Der Name des abzurufenden File
. Beispiel: files/abc-123
. Sie hat das Format files/{file}
.
Anfragetext
Der Anfragetext muss leer sein.
Beispielanfrage
Python
Node.js
Ok
Muschel
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von File
.
Methode: files.list
- Endpunkt
- Anfrageparameter
- Anfragetext
- Antworttext
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Beispielanfrage
<ph type="x-smartling-placeholder">
- </ph>
- Basic
Listet die Metadaten für File
s auf, die dem anfragenden Projekt gehören.
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> erhalten
https://generativelanguage.googleapis.com/v1beta/files
.
Abfrageparameter
pageSize
integer
Optional. Maximale Anzahl von File
s, die pro Seite zurückgegeben werden sollen. Wenn keine Vorgabe erfolgt, wird standardmäßig 10 verwendet. Der Höchstwert für pageSize
ist 100.
pageToken
string
Optional. Ein Seitentoken aus einem vorherigen files.list
-Aufruf.
Anfragetext
Der Anfragetext muss leer sein.
Beispielanfrage
Python
Node.js
Ok
Muschel
Antworttext
Antwort für files.list
.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
files[]
object (File
)
Die Liste der File
s.
nextPageToken
string
Ein Token, das als pageToken
an einen nachfolgenden files.list
-Aufruf gesendet werden kann.
JSON-Darstellung |
---|
{
"files": [
{
object ( |
Methode: files.delete
- Endpunkt
- Pfadparameter
- Anfragetext
- Antworttext
- Beispielanfrage
<ph type="x-smartling-placeholder">
- </ph>
- Basic
Löscht File
.
Endpunkt
<ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder"></ph> Löschen
https://generativelanguage.googleapis.com/v1beta/{name=files/*}
.
Pfadparameter
name
string
Erforderlich. Der Name der zu löschenden File
. Beispiel: files/abc-123
. Sie hat das Format files/{file}
.
Anfragetext
Der Anfragetext muss leer sein.
Beispielanfrage
Python
Node.js
Ok
Muschel
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
REST-Ressource: files
- Ressource: Datei
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- VideoMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Bundesland
- Status
<ph type="x-smartling-placeholder">
- </ph>
- JSON-Darstellung
- Methoden
Ressource: Datei
Eine in die API hochgeladene Datei.
name
string
Nicht veränderbar. Kennung. Der Ressourcenname File
. Die ID (Name ohne das Präfix „files/“) kann bis zu 40 Zeichen enthalten: kleingeschriebene alphanumerische Zeichen oder Bindestriche (-). Die ID darf nicht mit einem Bindestrich beginnen oder enden. Wenn der Name beim Erstellen leer ist, wird ein eindeutiger Name generiert. Beispiel: files/123-456
displayName
string
Optional. Der visuell lesbare Anzeigename für die File
. Der Anzeigename darf höchstens 512 Zeichen (einschließlich Leerzeichen) lang sein. Beispiel: „Willkommensbild“
mimeType
string
Nur Ausgabe. MIME-Typ der Datei.
sizeBytes
string (int64 format)
Nur Ausgabe. Größe der Datei in Byte.
createTime
string (Timestamp
format)
Nur Ausgabe. Der Zeitstempel für die Erstellung des File
.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
updateTime
string (Timestamp
format)
Nur Ausgabe. Der Zeitstempel der letzten Aktualisierung von File
.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
expirationTime
string (Timestamp
format)
Nur Ausgabe. Der Zeitstempel für das Löschen der File
. Wird nur festgelegt, wenn das File
abläuft.
Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z"
und "2014-10-02T15:01:23.045123456Z"
.
sha256Hash
string (bytes format)
Nur Ausgabe. SHA-256-Hash der hochgeladenen Byte.
Ein base64-codierter String.
uri
string
Nur Ausgabe. Der URI von File
.
state
enum (State
)
Nur Ausgabe. Verarbeitungsstatus der Datei.
error
object (Status
)
Nur Ausgabe. Fehlerstatus, wenn die Dateiverarbeitung fehlgeschlagen ist.
metadata
. Metadaten für die Datei. Für metadata
ist nur einer der folgenden Werte zulässig:
videoMetadata
object (VideoMetadata
)
Nur Ausgabe. Metadaten für ein Video.
JSON-Darstellung |
---|
{ "name": string, "displayName": string, "mimeType": string, "sizeBytes": string, "createTime": string, "updateTime": string, "expirationTime": string, "sha256Hash": string, "uri": string, "state": enum ( |
VideoMetadata
Metadaten für ein Video File
.
videoDuration
string (Duration
format)
Dauer des Videos
Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit "s
". Beispiel: "3.5s"
.
JSON-Darstellung |
---|
{ "videoDuration": string } |
Status
Status für den Lebenszyklus einer Datei.
Enums | |
---|---|
STATE_UNSPECIFIED |
Der Standardwert. Dieser Wert wird verwendet, wenn der Status weggelassen wird. |
PROCESSING |
Die Datei wird verarbeitet und kann noch nicht für die Inferenz verwendet werden. |
ACTIVE |
Die Datei wird verarbeitet und steht für die Inferenz zur Verfügung. |
FAILED |
Die Verarbeitung der Datei ist fehlgeschlagen. |
Status
Mit dem Typ Status
wird ein logisches Fehlermodell definiert, das für verschiedene Programmierumgebungen wie REST APIs und RPC APIs geeignet ist. Dieses Modell wird von gRPC verwendet. Jede Status
-Meldung enthält die folgenden drei Datenelemente: Fehlercode, Fehlermeldung und Fehlerdetails.
Weitere Informationen zu diesem Fehlermodell und zur Arbeit damit finden Sie in der API-Designanleitung.
code
integer
Der Statuscode, der idealerweise ein ENUM-Wert von google.rpc.Code
ist.
message
string
Eine an Entwickler gerichtete Fehlermeldung, die englischsprachig sein sollte. Jede Fehlermeldung an den Nutzer sollte lokalisiert und im Feld google.rpc.Status.details
gesendet werden. Sie kann auch clientseitig lokalisiert werden.
details[]
object
Eine Auflistung aller Meldungen, die die Fehlerdetails enthalten. Es gibt einen gemeinsamen Satz von Nachrichtentypen, die APIs verwenden können.
Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld "@type"
enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }
.
JSON-Darstellung |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |