方法：projects.locations.models.predict

不适用于 AutoML Video Intelligence 对象跟踪。

HTTP 请求

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

路径参数

参数
name

string

要请求其提供预测的模型的名称。

必须对指定的资源 name 具有以下 Google IAM 权限才能获得授权：

  • automl.models.predict

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 

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

object(ExamplePayload)

必填。用于执行预测的负载。负载必须与模型被训练来解决的问题类型相匹配。

params

map (key: string, value: string)

其他网域特定参数，任何字符串的长度均不得超过 25000 个字符。

响应正文

如果成功，响应正文将包含结构如下的数据：

PredictionService.Predict 的响应消息。

JSON 表示法 

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

object(AnnotationPayload)

预测结果。

metadata

map (key: string, value: string)

网域专有的附加预测响应元数据。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅身份验证概览。

ExamplePayload

用于训练或预测的样本数据。

AnnotationPayload

包含与 AutoML 相关的注释信息。

JSON 表示法 

{
  "annotationSpecId": string,
  "displayName": string,

  // Union field detail can be only one of the following:
  "classification": {
    object(ClassificationAnnotation)
  },
  "videoObjectTracking": {
    object(VideoObjectTrackingAnnotation)
  }
  // End of list of possible types for union field detail.
}
字段
annotationSpecId

string

仅限输出。与此注释相关的注释规范的资源 ID。注释规范来自祖先数据集或用于训练所用模型的数据集。

displayName

string

仅限输出。训练模型时 AnnotationSpec.display_name 的值。此字段在模型训练时会返回一个值，对于使用相同数据集训练的不同模型，返回值可能不同，因为模型所有者可以更新任何两个模型训练之间的 displayName。

联合字段 detail。仅限输出。有关 AutoML 解决方案特定注释的其他信息。detail 只能是下列其中一项：
classification

object(ClassificationAnnotation)

不适用于 AutoML Video Intelligence 对象跟踪。

videoObjectTracking

object(VideoObjectTrackingAnnotation)

对象跟踪预测的注释详情。

ClassificationAnnotation

包含特定于分类的注释详细信息。

JSON 表示法 

{
  "score": number
}
字段
score

number

仅限输出。介于 0.0 和 1.0 之间的置信度估计值。值越大意味着注释为正例的置信度越高。如果用户将注释批准为负例或正例，则分数值保持不变。如果用户创建注释，则分数为 0 时表示负例，为 1 时表示正例。

VideoObjectTrackingAnnotation

视频对象跟踪的注释详情。

JSON 表示法 

{
  "instanceId": string,
  "timeOffset": string,
  "boundingBox": {
    object(BoundingPoly)
  },
  "score": number
}
字段
instanceId

string

选填。对象的实例，表示为正整数。在单个示例中存在多个对象时，用于分离同类对象（即 AnnotationSpec）。注意：实例 ID 预测质量不属于模型评估，应尽力执行。特别是在实体离开屏幕较长时间（数分钟）的情况下，当它返回时，可能被赋予一个新的实例 ID。
timeOffset

string (Duration format)

必填。该注释所属的视频的时间（帧）。表示为视频播放的时长。

时长以秒为单位，最多包含九个小数位，并以“s”结束。例如："3.5s"。
boundingBox

object(BoundingPoly)

必填。矩形表示对象在帧上的位置（即在视频的 timeOffset 处）。

score

number

仅限输出。视频在 timeOffset 处的注释为正样本时的置信度，值范围为 [0,1]，该值越高意味着正置信度越高。对于用户创建的注释，分数为 1。当用户批准注释时，保留其原始浮点分数（并且不会更改为 1）。

BoundingPoly

平面上检测到的对象的外接多边形。输出中提供了顶点和规范化顶点。按列出的顺序连接顶点便可构成多边形。

JSON 表示法 

{
  "normalizedVertices": [
    {
      object(NormalizedVertex)
    }
  ]
}
字段
normalizedVertices[]

object(NormalizedVertex)

仅限输出。外接多边形的规范化顶点。

NormalizedVertex

顶点表示图像中的 2D 点。规范化顶点坐标相对于原始平面（图像、视频）在 0 到 1 之间。例如，如果平面（例如，整个图像）的尺寸为 10 x 20，则采用规范化坐标 (0.1, 0.3) 的点在该平面上的位置为 (1, 6)。

JSON 表示法 

{
  "x": number,
  "y": number
}
字段
x

number

必填。水平坐标。

y

number

必填。垂直坐标。