Methode: projects.locations.models.predict

Trifft eine Vorhersage.

HTTP-Anfrage

POST https://automl.googleapis.com/v1beta1/{name}:predict

Pfadparameter

Parameter
name

string

Name des Modells, das zur Vorhersage angefordert wurde.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • automl.models.predict

Anfragetext

Der Anfragetext enthält Daten mit der folgenden Struktur:

JSON-Darstellung 

{
  "payload": {
    object(ExamplePayload)
  },
  "params": {
    string: string,
    ...
  }
}
Felder
payload

object(ExamplePayload)

Erforderlich. Nutzlast bei der Ausführung einer Vorhersage. Die Nutzlast muss mit dem Problemtyp übereinstimmen, für den das Modell trainiert wurde.

params

map (key: string, value: string)

Zusätzliche domainspezifische Parameter. Jeder String kann bis zu 25.000 Zeichen umfassen.

  • Für die Bildklassifizierung:

score_threshold – (float) Ein Wert von 0,0 bis 1,0. Wenn das Modell Vorhersagen für ein Bild trifft, werden nur Ergebnisse erzeugt, die mindestens diesen Konfidenzschwellenwert haben. Der Standardwert ist 0,5.

Ein Objekt mit einer Liste der Paare "key": value. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht für PredictionService.Predict.

Derzeit wird dies nur verwendet, um ein Vorhersageergebnis zur Bilderkennung auszugeben. Weitere Ausgaben von Metadaten zu Vorhersagen werden möglicherweise in Zukunft eingeführt.

JSON-Darstellung 

{
  "payload": [
    {
      object(AnnotationPayload)
    }
  ],
  "metadata": {
    string: string,
    ...
  }
}
Felder
payload[]

object(AnnotationPayload)

Vorhersageergebnis.

metadata

map (key: string, value: string)

Zusätzliche domainspezifische Antwortmetadaten zu Vorhersagen.

Ein Objekt mit einer Liste der Paare "key": value. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }

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 payload can be only one of the following:
  "image": {
    object(Image)
  },
  "textSnippet": {
    object(TextSnippet)
  }
  // End of list of possible types for union field payload.
}
Felder
Union-Feld payload. Erforderlich. Nur Eingabe. Beispieldaten. Für payload ist nur einer der folgenden Werte zulässig:
image

object(Image)

Ein Beispielbild.

textSnippet

object(TextSnippet)

Beispieltext.

Bild

Darstellung eines Bilds.

JSON-Darstellung 

{
  "thumbnailUri": string,

  // Union field data can be only one of the following:
  "imageBytes": string,
  "inputConfig": {
    object(InputConfig)
  }
  // End of list of possible types for union field data.
}
Felder
thumbnailUri

string

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

string (bytes format)

Bildinhalt, dargestellt als ein Bytestream. Hinweis: Wie bei allen bytes-Feldern verwenden auch Protokollpuffer eine reine Binärdarstellung, während JSON-Darstellungen Base64 verwenden.

Ein base64-codierter String.
inputConfig

object(InputConfig)

Eine Eingabekonfiguration, die den Inhalt des Bilds angibt.

TextSnippet

Darstellung eines Text-Snippets.

JSON-Darstellung 

{
  "content": string,
  "mimeType": string,
  "contentUri": string
}
Felder
content

string

Erforderlich. Der Inhalt des Text-Snippets als String. Bis zu 250.000 Zeichen lang.

mimeType

string

Das Format des Ausgangstextes. Zum Beispiel "text/html" oder "text/plain". Wenn dieser Wert leer ist, wird das Format automatisch anhand des hochgeladenen Inhalts ermittelt. Die Standardeinstellung ist "text/html". Bis zu 25.000 Zeichen lang.

contentUri

string

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 detail can be only one of the following:
  "translation": {
    object(TranslationAnnotation)
  },
  "classification": {
    object(ClassificationAnnotation)
  }
  // End of list of possible types for union field detail.
}
Felder
annotationSpecId

string

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

string

Nur Ausgabe. Der Wert für AnnotationSpec.display_name, wenn das Modell trainiert wurde. Da dieses Feld beim Modelltraining einen Wert zurückgibt, kann der zurückgegebene Wert für verschiedene Modelle, die mit demselben Dataset trainiert werden, unterschiedlich sein. Das liegt daran, dass der Modellinhaber den displayName zwischen zwei beliebigen Modelltrainings aktualisieren kann.

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

object(TranslationAnnotation)

Annotationsdetails für die Übersetzung.

classification

object(ClassificationAnnotation)

Annotationsdetails für die Inhalts- oder Bildklassifizierung.

TranslationAnnotation

Spezifische Annotationsdetails für die Übersetzung.

JSON-Darstellung 

{
  "translatedContent": {
    object(TextSnippet)
  }
}
Felder
translatedContent

object(TextSnippet)

Nur Ausgabe. Übersetzter Inhalt.

ClassificationAnnotation

Enthält Annotationsdetails, die speziell für die Klassifizierung gelten.

JSON-Darstellung 

{
  "score": number
}
Felder
score

number

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.