Todos os produtos
Search
Central de documentação

:CreateFpShotDB

Última atualização: Jun 27, 2026

Envia um job para criar uma biblioteca de impressões digitais de mídia.

Observações de uso

  • Use esta operação para enviar um job de criação de biblioteca de impressões digitais de vídeo ou texto. A biblioteca de impressões digitais de texto armazena impressões digitais textuais.

  • Crie bibliotecas de impressões digitais de texto apenas na região China (Shanghai). Por padrão, envie até 10 jobs de criação de biblioteca de impressões digitais de vídeo por vez para uma fila do ApsaraVideo Media Processing (MPS). O envio simultâneo de mais de 10 jobs pode causar falha na chamada.

Limite de QPS

Esta operação permite até 100 chamadas por segundo por conta. Chamadas que excedem esse limite acionam o throttling e podem afetar seus serviços. Observe esse limite ao utilizar esta operação. Para mais informações, consulte Limite de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

CreateFpShotDB

Operação a executar. Defina o valor como CreateFpShotDB.

Name

String

Sim

example name

Nome da biblioteca de impressões digitais de mídia a criar.

ModelId

Integer

Não

11

ID do modelo da biblioteca de impressões digitais de mídia. Para criar uma biblioteca de impressões digitais de texto, defina o parâmetro como 11. Para biblioteca de impressões digitais de vídeo, defina como 12. Para áudio, utilize 13. O valor 14 indica uma biblioteca de impressões digitais de imagem.

Config

String

Não

null

Configurações da biblioteca de impressões digitais de mídia. Este parâmetro está vazio por padrão. Personalize as configurações conforme os requisitos do seu negócio. O valor deve ser uma string no formato JSON.

Description

String

Não

The library is a text fingerprint library.

Descrição da biblioteca de impressões digitais de mídia.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

25818875-5F78-4A13-BEF6-D7393642CA58

ID da solicitação.

FpShotDB

Object

Detalhes da biblioteca de impressões digitais de mídia.

Description

String

The library is a text fingerprint library.

Descrição da biblioteca de impressões digitais de mídia.

State

String

offline

Status da biblioteca de impressões digitais de mídia. Após a criação, a biblioteca entra no estado offline. Depois do processamento no backend, ela passa para o estado active.

Name

String

example-name-****

Nome da biblioteca de impressões digitais de mídia.

FpDBId

String

88c6ca184c0e47098a5b665e2a12****

ID da biblioteca de impressões digitais de mídia. Guarde este ID para chamadas de operações subsequentes.

ModelId

Integer

11

ID do modelo da biblioteca de impressões digitais de mídia.

Config

String

null

Configurações da biblioteca de impressões digitais de mídia.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=CreateFpShotDB
&Name=example name
&ModelId=11
&Config=null
&Description=The library is a text fingerprint library.
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateFpShotDBResponse>
    <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
    <FpShotDB>
        <Description>The library is a text fingerprint library.</Description>
        <State>offline</State>
        <Name>example-name-****</Name>
        <FpDBId>88c6ca184c0e47098a5b665e2a12****</FpDBId>
        <ModelId>11</ModelId>
        <Config>null</Config>
    </FpShotDB>
</CreateFpShotDBResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4A13-BEF6-D7393642CA58",
  "FpShotDB" : {
    "Description" : "The library is a text fingerprint library.",
    "State" : "offline",
    "Name" : "example-name-****",
    "FpDBId" : "88c6ca184c0e47098a5b665e2a12****",
    "ModelId" : 11,
    "Config" : "null"
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.