Partilhar via

Custom Models - Train

  • Referência
Serviço:
Azure AI Services
Versão da API:
2.1

Create e preparar um modelo personalizado. O pedido tem de incluir um parâmetro de origem que seja um Uri de contentor de blobs de armazenamento do Azure acessível externamente (de preferência um Uri de Assinatura de Acesso Partilhado) ou um caminho válido para uma pasta de dados numa unidade montada localmente. Quando os caminhos locais são especificados, têm de seguir o formato de caminho Linux/Unix e ter um caminho absoluto enraizado no valor da definição de configuração de montagem de entrada, por exemplo, se o valor da definição de configuração "{Mounts:Input}" for "/input", um caminho de origem válido seria "/input/contosodataset". Espera-se que todos os dados a serem preparados estejam na pasta de origem ou subpastas abaixo dos mesmos. Os modelos são preparados com documentos do seguinte tipo de conteúdo : "application/pdf", "image/jpeg", "image/png", "image/tiff" ou "image/bmp". Outro tipo de conteúdo é ignorado.

POST {endpoint}/formrecognizer/v2.1/custom/models

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
 path True

string

Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://westus2.api.cognitive.microsoft.com).

Cabeçalho do Pedido

Name Necessário Tipo Description
Ocp-Apim-Subscription-Key True

string

Corpo do Pedido

Name Necessário Tipo Description
source True

string

Caminho de origem que contém os documentos de preparação.
modelName

string

Nome de modelo definido pelo utilizador opcional (comprimento máximo: 1024).
sourceFilter

TrainSourceFilter

Filtre para aplicar aos documentos no caminho de origem para preparação.
useLabelFile

boolean

Utilize o ficheiro de etiqueta para preparar um modelo.

Respostas

Name Tipo Description
201 Created

O pedido é feito em fila com êxito.

Cabeçalhos

Location: string
Other Status Codes

ErrorResponse

Entidade de resposta que acompanha respostas não bem-sucedidas que contêm detalhes adicionais sobre o erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Train custom model
Train custom model with subfolder filter options

Train custom model

Pedido de amostra

POST {endpoint}/formrecognizer/v2.1/custom/models


{
  "source": "{azure_blob_endpoint}/input/data1?sasToken"
}

Resposta da amostra

Código de estado:
201 
Location: {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8

Train custom model with subfolder filter options

Pedido de amostra

POST {endpoint}/formrecognizer/v2.1/custom/models


{
  "source": "{azure_blob_endpoint}/input/data1?sasToken",
  "sourceFilter": {
    "prefix": "",
    "includeSubFolders": false
  },
  "useLabelFile": false
}

Resposta da amostra

Código de estado:
201 
Location: {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8

Definições

Name Description
ErrorInformation
ErrorResponse
TrainRequest

Pedir parâmetro para preparar um novo modelo personalizado.
TrainSourceFilter

Filtre para aplicar aos documentos no caminho de origem para preparação.

ErrorInformation

Name Tipo Description
code

string

message

string

ErrorResponse

Name Tipo Description
error

ErrorInformation

TrainRequest

Pedir parâmetro para preparar um novo modelo personalizado.

Name Tipo Default value Description
modelName

string

Nome de modelo definido pelo utilizador opcional (comprimento máximo: 1024).
source

string

Caminho de origem que contém os documentos de preparação.
sourceFilter

TrainSourceFilter

Filtre para aplicar aos documentos no caminho de origem para preparação.
useLabelFile

boolean

False

Utilize o ficheiro de etiqueta para preparar um modelo.

TrainSourceFilter

Filtre para aplicar aos documentos no caminho de origem para preparação.

Name Tipo Default value Description
includeSubFolders

boolean

False

Um sinalizador para indicar se as subpastas no conjunto de pastas de prefixo também terão de ser incluídas ao procurar conteúdo a pré-processar.
prefix

string

Uma cadeia de prefixo sensível a maiúsculas e minúsculas para filtrar documentos no caminho de origem para preparação. Por exemplo, ao utilizar um Uri de blob de armazenamento do Azure, utilize o prefixo para restringir subpastas para preparação.