Azure AI Video Indexer API를 사용하여 브랜드 모델 사용자 지정

  • 아티클

Important

Azure Media Services 사용 중지 발표로 인해 Azure AI Video Indexer는 Azure AI Video Indexer 기능 조정을 발표합니다. AZURE AI Video Indexer 계정에 대한 의미를 이해하려면 AMS(Azure Media Service) 사용 중지와 관련된 변경 내용을 참조하세요. AMS 사용 중지 준비: VI 업데이트 및 마이그레이션 가이드를 참조하세요.

Azure AI Video Indexer는 비디오 및 오디오 콘텐츠의 인덱싱 및 재인덱싱 동안 연설 및 시각적 텍스트에서 브랜드를 검색하도록 지원합니다. 브랜드 검색 기능은 Bing의 브랜드 데이터베이스에서 제안하는 제품, 서비스 및 회사의 멘션을 식별합니다. 예를 들어 Microsoft가 비디오 또는 오디오 콘텐츠에 언급되거나 비디오의 시각적 텍스트에 표시되는 경우 Azure AI Video Indexer는 이를 콘텐츠의 브랜드로 검색합니다. 사용자 지정 브랜드 모델을 사용하면 특정 브랜드가 검색되지 않도록 제외하고, Bing 브랜드 데이터베이스에 없을 수 있으며 모델에 포함되어야 하는 브랜드를 포함할 수 있습니다. 자세한 내용은 개요를 참조하세요.

참고 항목

브랜드를 추가하기에 앞서 비디오가 인덱싱된 경우 다시 인덱싱해야 합니다.

Azure AI Video Indexer API를 사용하여 이 항목에 설명된 것처럼 비디오에서 검색되는 사용자 지정 브랜드 모델을 생성, 사용 및 편집할 수 있습니다. Azure AI Video Indexer 웹 사이트를 사용하여 브랜드 모델 사용자 지정에 설명된 대로 Azure AI Video Indexer 웹 사이트를 사용할 수도 있습니다.

브랜드 만들기

브랜드 만들기 API는 새 사용자 지정 브랜드를 만들어 지정된 계정의 사용자 지정 브랜드 모델에 추가합니다.

참고 항목

enabled(본문에 있음)를 true로 설정하면 Azure AI Video Indexer에서 검색할 포함 목록에 해당 브랜드가 배치됩니다. enabled를 false로 설정하면 해당 브랜드가 제외 목록에 있으므로 Azure AI Video Indexer에서 검색하지 않습니다.

다음은 본문에서 설정할 수 있는 몇 가지 다른 매개 변수입니다.

  • referenceUrl 값은 해당 Wikipedia 페이지 링크와 같은 브랜드에 대한 참조 웹 사이트일 수 있습니다.
  • tags 값은 브랜드의 태그 목록입니다. 이 태그는 Azure AI Video Indexer 웹 사이트에서 브랜드의 범주 필드에 표시됩니다. 예를 들어 “Azure” 브랜드는 “클라우드”로 태그를 지정하거나 분류할 수 있습니다.

응답

응답은 방금 만든 브랜드에 대한 정보를 아래 예제 형식으로 제공합니다.

{
  "referenceUrl": "https://en.wikipedia.org/wiki/Example",
  "id": 97974,
  "name": "Example",
  "accountId": "SampleAccountId",
  "lastModifierUserName": "SampleUserName",
  "created": "2018-04-25T14:59:52.7433333",
  "lastModified": "2018-04-25T14:59:52.7433333",
  "enabled": true,
  "description": "This is an example",
  "tags": [
    "Tag1",
    "Tag2"
  ]
}

브랜드 삭제

브랜드 삭제 API는 지정된 계정에 대해 사용자 지정 브랜드 모델에서 브랜드를 제거합니다. 계정은 accountId 매개 변수에서 지정됩니다. 성공적으로 호출하면 브랜드가 더 이상 ‘포함’ 또는 ‘제외’ 브랜드 목록에 없습니다.

응답

브랜드를 성공적으로 삭제한 경우 반환되는 콘텐츠가 없습니다.

특정 브랜드 가져오기

브랜드 가져오기 API를 사용하면 브랜드 ID를 통해 지정된 계정의 사용자 지정 브랜드 모델에서 브랜드 세부 정보를 검색할 수 있습니다.

응답

응답은 브랜드 ID를 사용하여 검색한 브랜드에 대한 정보를 아래 예제 형식으로 제공합니다.

{
  "referenceUrl": "https://en.wikipedia.org/wiki/Example",
  "id": 128846,
  "name": "Example",
  "accountId": "SampleAccountId",
  "lastModifierUserName": "SampleUserName",
  "created": "2018-01-06T13:51:38.3666667",
  "lastModified": "2018-01-11T13:51:38.3666667",
  "enabled": true,
  "description": "This is an example",
  "tags": [
    "Tag1",
    "Tag2"
  ]
}

참고 항목

enabled를 true로 설정하면 해당 브랜드가 Azure AI Video Indexer에서 검색할 포함 목록에 배치되고, enabled를 false로 설정하면 해당 브랜드가 제외 목록에 배치되어 Azure AI Video Indexer에서 검색하지 않습니다.

특정 브랜드 업데이트

브랜드 업데이트 API를 사용하면 브랜드 ID를 통해 지정된 계정의 사용자 지정 브랜드 모델에서 브랜드 세부 정보를 검색할 수 있습니다.

응답

응답은 업데이트한 브랜드에 대한 업데이트된 정보를 아래 예제 형식으로 제공합니다.

{
  "referenceUrl": null,
  "id": 97974,
  "name": "Example",
  "accountId": "SampleAccountId",
  "lastModifierUserName": "SampleUserName",
  "Created": "2018-04-25T14:59:52.7433333",
  "lastModified": "2018-04-25T15:37:50.67",
  "enabled": false,
  "description": "This is an update example",
  "tags": [
    "Tag1",
    "NewTag2"
  ]
}

모든 브랜드 가져오기

모든 브랜드 가져오기 API를 사용하면 브랜드가 포함 또는 제외 브랜드 목록에 배치되는지에 관계없이 지정된 계정의 사용자 지정 브랜드 모델에 있는 모든 브랜드가 반환됩니다.

응답

응답은 계정의 모든 브랜드 목록과 각 세부 정보를 아래 예제의 형식으로 제공합니다.

[
    {
        "ReferenceUrl": null,
        "id": 97974,
        "name": "Example",
        "accountId": "AccountId",
        "lastModifierUserName": "UserName",
        "Created": "2018-04-25T14:59:52.7433333",
        "LastModified": "2018-04-25T14:59:52.7433333",
        "enabled": true,
        "description": "This is an example",
        "tags": ["Tag1", "Tag2"]
    },
    {
        "ReferenceUrl": null,
        "id": 97975,
        "name": "Example2",
        "accountId": "AccountId",
        "lastModifierUserName": "UserName",
        "Created": "2018-04-26T14:59:52.7433333",
        "LastModified": "2018-04-26T14:59:52.7433333",
        "enabled": false,
        "description": "This is another example",
        "tags": ["Tag1", "Tag2"]
    },
]

참고 항목

Example 브랜드는 Azure AI Video Indexer에서 검색할 포함 목록에 있고, Example2 브랜드는 제외 목록에 있으므로 Azure AI Video Indexer에서 검색하지 않습니다.

브랜드 모델 설정 가져오기

브랜드 설정 가져오기 API는 지정된 계정의 브랜드 모델 설정을 반환합니다. 브랜드 모델 설정은 Bing 브랜드 데이터베이스에서 검색을 사용할지 여부를 나타냅니다. Bing 브랜드를 사용하도록 설정하지 않은 경우 Azure AI Video Indexer는 지정된 계정의 사용자 지정 브랜드 모델에서만 해당 브랜드를 검색합니다.

응답

응답은 Bing 브랜드의 사용 여부를 아래 예제 형식으로 표시합니다.

{
  "state": true,
  "useBuiltIn": true
}

참고 항목

useBuiltIn을 true로 설정하면 Bing 브랜드가 사용됩니다. useBuiltin이 false인 경우 Bing 브랜드가 사용하지 않도록 설정됩니다. state 값은 사용되지 않았으므로 무시해도 됩니다.

브랜드 모델 설정 업데이트

브랜드 업데이트 API는 지정된 계정의 브랜드 모델 설정을 업데이트합니다. 브랜드 모델 설정은 Bing 브랜드 데이터베이스에서 검색을 사용할지 여부를 나타냅니다. Bing 브랜드를 사용하도록 설정하지 않은 경우 Azure AI Video Indexer는 지정된 계정의 사용자 지정 브랜드 모델에서만 해당 브랜드를 검색합니다.

True로 설정된 useBuiltIn 플래그는 Bing 브랜드를 사용하도록 설정되어 있음을 의미합니다. useBuiltin이 false인 경우 Bing 브랜드가 사용하지 않도록 설정됩니다.

응답

브랜드 모델 설정이 성공적으로 업데이트되었을 때는 반환되는 콘텐츠가 없습니다.