Método: projects.locations.models.predict

Não disponível para o AutoML Video Intelligence.

Solicitação HTTP

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

Parâmetros de caminho

Parâmetros
name

string

Nome do modelo solicitado para disponibilizar a predição.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • automl.models.predict

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 

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

object(ExamplePayload)

Obrigatório. Payload para realizar uma previsão. O payload precisa corresponder ao tipo de problema que o modelo foi treinado para resolver.

params

map (key: string, value: string)

Outros parâmetros específicos de domínio, qualquer string precisa ter até 25.000 caracteres de comprimento.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Mensagem de resposta de PredictionService.Predict.

Representação JSON 

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

object(AnnotationPayload)

Resultado da predição.

metadata

map (key: string, value: string)

Outros metadados de resposta de predição específica do domínio.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

ExamplePayload

Dados de exemplo usados em treinamento ou predição.

AnnotationPayload

Contém informações de anotação relevantes para AutoML.

Representação 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.
}
Campos
annotationSpecId

string

Somente saída. O código do recurso da especificação de anotação a que essa anotação pertence. A especificação de anotação vem de um conjunto de dados ancestral ou do conjunto de dados que foi usado para treinar o modelo em uso.

displayName

string

Somente saída. O valor de AnnotationSpec.display_name quando o modelo foi treinado. Como esse campo retorna um valor no tempo de treinamento de modelo, para modelos diferentes treinados usando o mesmo conjunto de dados, o valor retornado pode ser diferente, porque o proprietário do modelo pode atualizar o displayName entre dois treinamentos de modelo quaisquer.

Campo de união detail. Somente saída. Informações adicionais sobre a anotação específica da solução AutoML. detail só pode ser um destes:
classification

object(ClassificationAnnotation)

Detalhes de anotação para predições de classificação.

videoClassification

object(VideoClassificationAnnotation)

Detalhes de anotação para classificação de vídeo. Retornado para predições de classificação de vídeos.

ClassificationAnnotation

Contém detalhes da anotação específicos à classificação.

Representação JSON 

{
  "score": number
}
Campos
score

number

Somente saída. Uma estimativa de confiança entre 0,0 e 1,0. Um valor mais alto significa mais confiança de que a anotação seja positiva. Se um usuário aprovar uma anotação como negativa ou positiva, o valor da pontuação permanecerá inalterado. Se um usuário criar uma anotação, a pontuação será 0 para negativo ou 1 para positivo.

VideoClassificationAnnotation

Contém detalhes da anotação específicos da classificação de vídeo.

Representação JSON 

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

string

Somente saída. Expressa o tipo de classificação de vídeo. Valores possíveis:

  • segment - classificação feita em um período especificado pelo usuário de um vídeo. O AnnotationSpec é respondido para estar presente nesse período, se estiver presente em qualquer parte dele. As avaliações do modelo de ML de vídeo são feitas apenas para este tipo de classificação.

  • shot - classificação de nível de tomada. O AutoML Video Intelligence determina os limites de cada tomada de câmera em todo o segmento do vídeo especificado pelo usuário na configuração de solicitação. O AutoML Video Intelligence retorna rótulos e os valores de confiança para cada tomada detectada, com o horário de início e término da tomada. AVISO: a avaliação do modelo não é feita para esse tipo de classificação, a qualidade depende dos dados de treinamento, mas não há métricas fornecidas para descrever essa qualidade.

  • 1s_interval - o AutoML Video Intelligence retorna rótulos e os valores de confiança para cada segundo de todo o segmento do vídeo que o usuário especificou na configuração da solicitação. AVISO: a avaliação do modelo não é feita para esse tipo de classificação, a qualidade depende dos dados de treinamento, mas não há métricas fornecidas para descrever essa qualidade.
classificationAnnotation

object(ClassificationAnnotation)

Somente saída. Os detalhes da classificação desta anotação.

timeSegment

object(TimeSegment)

Somente saída. O período do vídeo ao qual a anotação se aplica.

TimeSegment

Um período dentro de um exemplo que tem uma dimensão de tempo (por exemplo, vídeo).

Representação JSON 

{
  "startTimeOffset": string,
  "endTimeOffset": string
}
Campos
startTimeOffset

string (formato Duration)

Início do período (inclusivo), representado pela duração desde o início do exemplo.

A duração em segundos com até nove dígitos fracionais, com terminação “s”. Exemplo: "3.5s".
endTimeOffset

string (formato Duration)

Fim do período (exclusivo), representado pela duração desde o início do exemplo.

A duração em segundos com até nove dígitos fracionais, com terminação “s”. Exemplo: "3.5s".