方法: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)
  },
  "videoClassification": {
    object(VideoClassificationAnnotation)
  }
  // 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)

关于分类预测的注释详情。

videoClassification

对象( VideoClassificationAnnotation

关于视频分类的注释详情。为视频分类预测返回此项。

ClassificationAnnotation

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

JSON 表示法

{
  "score": number
}
字段
score

number

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

VideoClassificationAnnotation

包含视频分类的专用注释详细信息。

JSON 表示法

{
  "type": string,
  "classificationAnnotation": {
    object(ClassificationAnnotation)
  },
  "timeSegment": {
    object(TimeSegment)
  }
}
字段
type

string

仅限输出。表示视频分类的类型。可能的值:

  • segment - 已按用户指定的视频时间段进行分类。如果 AnnotationSpec 存在于该时间段的任何部分,则报告 AnnotationSpec 存在于该时间段中。视频机器学习模型评估仅适用于这种分类。

  • shot - 镜头级分类。AutoML Video Intelligence 确定用户在请求配置中指定的整个视频片段中每个镜头的边界。然后,AutoML Video Intelligence 会返回检测到的每个镜头的标签及其置信度分数,以及镜头的开始和结束时间。警告:对于该分类类型,不执行模型评估,分类的质量取决于训练数据,但不提供用于描述该质量的指标。

  • 1s_interval - AutoML Video Intelligence 返回用户在请求配置中指定的整个视频片段每一秒的标签及其置信度分数。警告:对于该分类类型,不执行模型评估,分类的质量取决于训练数据,但不提供用于描述该质量的指标。

classificationAnnotation

object(ClassificationAnnotation)

仅限输出。此注释的分类详情。

timeSegment

object(TimeSegment)

仅限输出。注释适用的视频时间段。

TimeSegment

具有时间维度的样本(例如,视频)内的时间段。

JSON 表示法

{
  "startTimeOffset": string,
  "endTimeOffset": string
}
字段
startTimeOffset

string (Duration format)

时间段的开始时间(含边界值),表示为自样本启动以来的时长。

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

endTimeOffset

string (Duration format)

时间段结束时间(不含边界值),表示为自样本启动以来的时长。

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