- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ExamplePayload
- Bild
- TextSnippet
- AnnotationPayload
- TranslationAnnotation
- ClassificationAnnotation
- VideoClassificationAnnotation
- TimeSegment
Führt eine Onlinevorhersage durch. Das Vorhersageergebnis wird unmittelbar in der Antwort zurückgegeben.
Verfügbar für folgende ML-Probleme und deren erwarteten Anfragenutzlasten:
- Bildklassifizierung – Bilder im JPEG-, GIF- oder PNG-Format, imageBytes bis zu 30 MB.
- Textklassifizierung – TextSnippet, kann bis zu 10.000 Zeichen enthalten, UTF-8-codiert.
- Übersetzung – TextSnippet, kann bis zu 25.000 Zeichen enthalten, UTF-8-codiert.
HTTP-Anfrage
POST https://automl.googleapis.com/v1beta1/{name}:predict
Pfadparameter
Parameter | |
---|---|
name |
Name des Modells, das zur Vorhersage angefordert wurde. Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung | |
---|---|
{
"payload": {
object( |
Felder | |
---|---|
payload |
Erforderlich. Nutzlast bei der Ausführung einer Vorhersage. Die Nutzlast muss mit dem Problemtyp übereinstimmen, für den das Modell trainiert wurde. |
params |
Zusätzliche domainspezifische Parameter. Jeder String kann bis zu 25.000 Zeichen umfassen.
Ein Objekt mit einer Liste der Paare |
Antworttext
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Antwortnachricht für PredictionService.Predict
.
JSON-Darstellung | |
---|---|
{
"payload": [
{
object( |
Felder | |
---|---|
payload[] |
Vorhersageergebnis. Übersetzung und Textsentimente liefern genau eine Nutzlast. |
metadata |
Zusätzliche domainspezifische Antwortmetadaten zu Vorhersagen. Ein Objekt mit einer Liste der Paare |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cloud-platform
Weitere Informationen finden Sie in der Authentifizierungsübersicht.
ExamplePayload
Beispieldaten für Training oder Vorhersage.
JSON-Darstellung | |
---|---|
{ // Union field |
Felder | ||
---|---|---|
Union-Feld payload . Erforderlich. Nur Eingabe. Beispieldaten. Für payload ist nur einer der folgenden Werte zulässig: |
||
image |
Beispielbild. |
|
textSnippet |
Beispieltext. |
Bild
Darstellung eines Bilds. Es werden nur Bilder mit einer Größe von bis zu 30 MB unterstützt.
JSON-Darstellung | |
---|---|
{ "thumbnailUri": string, // Union field |
Felder | ||
---|---|---|
thumbnailUri |
Nur Ausgabe. HTTP-URI zur Miniaturansicht. |
|
Union-Feld data . Nur Eingabe. Die Daten, die das Bild darstellen. Für Predict-Aufrufe muss [image_bytes] [] festgelegt werden, da andere Optionen derzeit nicht von der Prediction API unterstützt werden. Mit dem Feld [content_uri][] können Sie den Inhalt eines hochgeladenen Bilds lesen. Für data ist nur einer der folgenden Werte zulässig: |
||
imageBytes |
Bildinhalt, dargestellt als ein Bytestream. Hinweis: Wie bei allen Ein base64-codierter String. |
|
inputConfig |
Eine Eingabekonfiguration, die den Inhalt des Bilds angibt. |
TextSnippet
Darstellung eines Text-Snippets.
JSON-Darstellung | |
---|---|
{ "content": string, "mimeType": string, "contentUri": string } |
Felder | |
---|---|
content |
Erforderlich. Der Inhalt des Text-Snippets als String. Bis zu 250.000 Zeichen lang. |
mimeType |
Das Format des Ausgangstextes. Aktuell sind nur zwei Werte zulässig: "text/html" und "text/plain". Wenn dieser Wert leer ist, wird das Format automatisch anhand des hochgeladenen Inhalts ermittelt. |
contentUri |
Nur Ausgabe. HTTP-URI, unter dem Sie den Inhalt herunterladen können. |
AnnotationPayload
Enthält Annotationsinformationen, die für AutoML relevant sind.
JSON-Darstellung | |
---|---|
{ "annotationSpecId": string, "displayName": string, // Union field |
Felder | ||
---|---|---|
annotationSpecId |
Nur Ausgabe. Die Ressourcen-ID der Annotationsspezifikation, auf die sich diese Annotation bezieht. Die Annotationsspezifikation stammt entweder aus einem Ancestor-Dataset oder aus dem Dataset, das zum Trainieren des eingesetzten Modells verwendet wurde. |
|
displayName |
Nur Ausgabe. Der Wert für |
|
Union-Feld detail . Nur Ausgabe. Zusätzliche Informationen zur Annotation, die für die AutoML-Lösung spezifisch ist. Für detail ist nur eine der folgenden Annotationen zulässig: |
||
translation |
Annotationsdetails für die Übersetzung. |
|
classification |
Annotationsdetails für die Inhalts- oder Bildklassifizierung. |
|
videoClassification |
Annotationsdetails für die Videoklassifizierung. Wird für Vorhersagen für die Videoklassifizierung zurückgegeben. |
TranslationAnnotation
Spezifische Annotationsdetails für die Übersetzung.
JSON-Darstellung | |
---|---|
{
"translatedContent": {
object( |
Felder | |
---|---|
translatedContent |
Nur Ausgabe. Übersetzter Inhalt. |
ClassificationAnnotation
Enthält Annotationsdetails, die speziell für die Klassifizierung gelten.
JSON-Darstellung | |
---|---|
{ "score": number } |
Felder | |
---|---|
score |
Nur Ausgabe. Eine Konfidenzschätzung zwischen 0,0 und 1,0. Je höherer der Wert ist, desto wahrscheinlicher ist eine positive Annotation. Bestätigt der Nutzer eine Annotation als negativ oder positiv, bleibt der Wert unverändert. Erstellt der Nutzer eine Annotation, ist 0 der Wert für negativ und 1 der Wert für positiv. |
VideoClassificationAnnotation
Enthält Annotationsdetails, die speziell für die Videoklassifizierung gelten.
JSON-Darstellung | |
---|---|
{ "type": string, "classificationAnnotation": { object( |
Felder | |
---|---|
type |
Nur Ausgabe. Drückt die Art der Videoklassifizierung aus. Mögliche Werte: * |
classificationAnnotation |
Nur Ausgabe. Die Klassifizierungsdetails dieser Annotation. |
timeSegment |
Nur Ausgabe. Das Zeitsegment des Videos, für das die Annotation gilt. |
TimeSegment
Ein Zeitraum innerhalb eines Beispiels mit einer Zeitdimension (zum Beispiel Video).
JSON-Darstellung | |
---|---|
{ "startTimeOffset": string, "endTimeOffset": string } |
Felder | |
---|---|
startTimeOffset |
Beginn des Zeitsegments (einschließlich), dargestellt als Dauer seit dem Start des Beispiels. Eine Zeitangabe in Sekunden mit bis zu neun Nachkommastellen und |
endTimeOffset |
Ende des Zeitsegments (exklusiv), dargestellt als Dauer seit dem Start des Beispiels. Eine Zeitangabe in Sekunden mit bis zu neun Nachkommastellen und |