<link crossorigin="anonymous" media="all" integrity="sha512-2NgDCU40htWjl2BQJcPMK+yfLjQpy9RVDqFIAuKKu6Hhjbf9yynqs9Z3ghZqLoesxs0/k6veHaKQ/gaVx3zDKA==" rel="stylesheet" href="https://github.githubassets.com/assets/github-61558f0e67a914c311cf66c3443ac94c.css" />
<meta property="og:image" content="https://avatars3.githubusercontent.com/u/22479449?s=400&v=4" /><meta property="og:site_name" content="GitHub" /><meta property="og:type" content="object" /><meta property="og:title" content="MicrosoftDocs/azure-docs-pr" /><meta property="og:url" content="https://github.com/MicrosoftDocs/azure-docs-pr" /><meta property="og:description" content="Contribute to MicrosoftDocs/azure-docs-pr development by creating an account on GitHub." />
<meta name="google-site-verification" content="KT5gs8h0wvaagLKAVWq8bbeNwnZZK1r1XQysX3xurLU">
<meta name="google-site-verification" content="ZzhVyEFwb7w3e0-uOTltm8Jsck2F5StVihD0exw2fsA">
<meta name="google-site-verification" content="GXs5KoUUkNCoaAZn7wPN-t01Pywp9M3sEjnt_3_ZWPc">
<meta name="google-analytics" content="UA-3769691-2">
<meta name="hostname" content="github.com">
<meta name="user-login" content="lebronJ">
<meta name="expected-hostname" content="github.com">
<meta name="js-proxy-site-detection-payload" content="MzQyOTJiMzMwYTA1NTg5NmI4OTI2NTVhOTBkYzYzMjdkOTEzZWI3MzI3MmEyM2QzNzQzZDVlZjEwYTRjNjM5M3x7InJlbW90ZV9hZGRyZXNzIjoiMTY3LjIyMC4yMzIuMzUiLCJyZXF1ZXN0X2lkIjoiQjEyQzo3NzVDOjA3NjI6MjgwQTo1QzdGODA3RCIsInRpbWVzdGFtcCI6MTU1MTg1OTg0NCwiaG9zdCI6ImdpdGh1Yi5jb20ifQ==">
<meta name="enabled-features" content="UNIVERSE_BANNER,MARKETPLACE_SOCIAL_PROOF,MARKETPLACE_PLAN_RESTRICTION_EDITOR,NOTIFY_ON_BLOCK,RELATED_ISSUES,MARKETPLACE_BROWSING_V2">
<link href="https://github.com/MicrosoftDocs/azure-docs-pr/commits/db02cb39050636f33a36e6e7fc9b20e9ebb225c6.atom?token=AScfkPy1bARMe1Ko6FZOC43vto9I2a01ks66jLMEwA%3D%3D" rel="alternate" title="Recent Commits to azure-docs-pr:db02cb39050636f33a36e6e7fc9b20e9ebb225c6" type="application/atom+xml">
<link rel="canonical" href="https://github.com/MicrosoftDocs/azure-docs-pr/blob/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services/Face/Face-API-How-to-Topics/specify-recognition-model.md" data-pjax-transient>
Skip to content
Issues
Marketplace
Explore
</div>
</div>
<div class="HeaderMenu d-flex flex-justify-between flex-auto">
<nav class="d-flex" aria-label="Global">
<div class="">
<div class="header-search scoped-search site-scoped-search js-site-search position-relative js-jump-to"
role="combobox" aria-owns="jump-to-results" aria-label="Search or jump to" aria-haspopup="listbox" aria-expanded="false"
<div class="Box position-absolute overflow-hidden d-none jump-to-suggestions js-jump-to-suggestions-container">
- No suggested jump to results
-
<img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28"> <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target"> </div> <div class="border rounded-1 flex-shrink-0 bg-gray px-1 text-gray-light ml-1 f6 d-none js-jump-to-badge-search"> <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository"> In this repository </span> <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub"> All GitHub </span> <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span> </div> <div aria-hidden="true" class="border rounded-1 flex-shrink-0 bg-gray px-1 text-gray-light ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump"> Jump to <span class="d-inline-block ml-1 v-align-middle">↵</span> </div> -
<img class="avatar mr-2 flex-shrink-0 js-jump-to-suggestion-avatar d-none" alt="" aria-label="Team" src="" width="28" height="28"> <div class="jump-to-suggestion-name js-jump-to-suggestion-name flex-auto overflow-hidden text-left no-wrap css-truncate css-truncate-target"> </div> <div class="border rounded-1 flex-shrink-0 bg-gray px-1 text-gray-light ml-1 f6 d-none js-jump-to-badge-search"> <span class="js-jump-to-badge-search-text-default d-none" aria-label="in this repository"> In this repository </span> <span class="js-jump-to-badge-search-text-global d-none" aria-label="in all of GitHub"> All GitHub </span> <span aria-hidden="true" class="d-inline-block ml-1 v-align-middle">↵</span> </div> <div aria-hidden="true" class="border rounded-1 flex-shrink-0 bg-gray px-1 text-gray-light ml-1 f6 d-none d-on-nav-focus js-jump-to-badge-jump"> Jump to <span class="d-inline-block ml-1 v-align-middle">↵</span> </div>
<li class="d-flex flex-justify-center flex-items-center p-0 f5 js-jump-to-suggestion">
<img src="https://github.githubassets.com/images/spinners/octocat-spinner-128.gif" alt="Octocat Spinner Icon" class="m-2" width="28">
</li>
</div>
</label>
</div>
<ul class="d-flex pl-2 flex-items-center text-bold list-style-none">
<li>
<a class="js-selected-navigation-item HeaderNavlink px-2" data-hotkey="g p" data-ga-click="Header, click, Nav menu - item:pulls context:user" aria-label="Pull requests you created" data-selected-links="/pulls /pulls/assigned /pulls/mentioned /pulls" href="/pulls">
Pull requests
<div class="d-flex">
-
</span> -
New repository Import repository New gist New organizationThis repositoryNew issue</details-menu> </details> -
<details class="details-overlay details-reset d-flex pl-2 flex-items-center"> <summary class="HeaderNavlink name mt-1" aria-label="View profile and more" data-ga-click="Header, show menu, icon:avatar"> <img alt="@lebronJ" class="avatar float-left mr-1" src="https://avatars0.githubusercontent.com/u/19341200?s=40&v=4" height="20" width="20"> <span class="dropdown-caret"></span> </summary> <details-menu class="dropdown-menu dropdown-menu-sw"> <div class="header-nav-current-user css-truncate"><a role="menuitem" class="no-underline user-profile-link px-3 pt-2 pb-2 mb-n2 mt-n1 d-block" href="/lebronJ" data-ga-click="Header, go to profile, text:Signed in as">Signed in as <strong class="css-truncate-target">lebronJ</strong></a></div> <div role="none" class="dropdown-divider"></div> <div class="px-3 f6 user-status-container js-user-status-context pb-1" data-url="/users/status?compact=1&link_mentions=0&truncate=1">Set your statusCould not update your status, please try again.80 remainingSet status Clear status</div> <div role="none" class="dropdown-divider"></div> <a role="menuitem" class="dropdown-item" href="/lebronJ" data-ga-click="Header, go to profile, text:your profile">Your profile</a> <a role="menuitem" class="dropdown-item" href="/lebronJ?tab=repositories" data-ga-click="Header, go to repositories, text:your repositories">Your repositories</a> <a role="menuitem" class="dropdown-item" href="/lebronJ?tab=projects" data-ga-click="Header, go to projects, text:your projects">Your projects</a> <a role="menuitem" class="dropdown-item" href="/lebronJ?tab=stars" data-ga-click="Header, go to starred repos, text:your stars">Your stars</a> <a role="menuitem" class="dropdown-item" href="https://gist.github.com/" data-ga-click="Header, your gists, text:your gists">Your gists</a> <div role="none" class="dropdown-divider"></div> <a role="menuitem" class="dropdown-item" href="https://help.github.com" data-ga-click="Header, go to help, text:help">Help</a> <a role="menuitem" class="dropdown-item" href="/settings/profile" data-ga-click="Header, go to settings, icon:settings">Settings</a> <!-- '"` --><!-- </textarea></xmp> --></option></form><form class="logout-form" action="/logout" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="0Hbpd4Lyf9g4AOSzeeu/dxewCpsyY0ZMUgfXH0aHmZ/rOAqrV8Y9LwZp+2+zLPAFO0rzcHI2VnAHxrY0qTuttQ==" /> <button type="submit" class="dropdown-item dropdown-signout" data-ga-click="Header, sign out, icon:logout" role="menuitem"> Sign out </button>
<!-- '"` --><!-- </textarea></xmp> --></option></form><form class="sr-only right-0" action="/logout" accept-charset="UTF-8" method="post"><input name="utf8" type="hidden" value="✓" /><input type="hidden" name="authenticity_token" value="qmDhPovnEK4DwAcU3ptLM16I/UzELXtxlhgEF2oSpf6RLgLiXtNSWT2pGMgUXARBcnIEp4R4a03D2WU8ha6R1A==" />
<button type="submit" class="dropdown-item dropdown-signout" data-ga-click="Header, sign out, icon:logout">
Sign out
</button>
<div id="js-flash-container">
<ul class="pagehead-actions">
<details class="details-reset details-overlay select-menu float-left">
<summary class="btn btn-sm btn-with-count select-menu-button" data-ga-click="Repository, click Watch settings, action:blob#show">
<span data-menu-button>
<svg class="octicon octicon-eye v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.06 2C3 2 0 8 0 8s3 6 8.06 6C13 14 16 8 16 8s-3-6-7.94-6zM8 12c-2.2 0-4-1.78-4-4 0-2.2 1.8-4 4-4 2.22 0 4 1.8 4 4 0 2.22-1.78 4-4 4zm2-4c0 1.11-.89 2-2 2-1.11 0-2-.89-2-2 0-1.11.89-2 2-2 1.11 0 2 .89 2 2z"/></svg>
Watch
</span>
</summary>
<details-menu class="select-menu-modal position-absolute mt-5" style="z-index: 99;">
<div class="select-menu-header">
<span class="select-menu-title">Notifications</span>
</div>
<div class="select-menu-list">
<button type="submit" name="do" value="included" class="select-menu-item width-full" aria-checked="true" role="menuitemradio">
<svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg>
<div class="select-menu-item-text">
<span class="select-menu-item-heading">Not watching</span>
<span class="description">Be notified only when participating or @mentioned.</span>
<span class="hidden-select-button-text" data-menu-button-contents>
<svg class="octicon octicon-eye v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.06 2C3 2 0 8 0 8s3 6 8.06 6C13 14 16 8 16 8s-3-6-7.94-6zM8 12c-2.2 0-4-1.78-4-4 0-2.2 1.8-4 4-4 2.22 0 4 1.8 4 4 0 2.22-1.78 4-4 4zm2-4c0 1.11-.89 2-2 2-1.11 0-2-.89-2-2 0-1.11.89-2 2-2 1.11 0 2 .89 2 2z"/></svg>
Watch
</span>
</div>
</button>
<button type="submit" name="do" value="release_only" class="select-menu-item width-full" aria-checked="false" role="menuitemradio">
<svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg>
<div class="select-menu-item-text">
<span class="select-menu-item-heading">Releases only</span>
<span class="description">Be notified of new releases, and when participating or @mentioned.</span>
<span class="hidden-select-button-text" data-menu-button-contents>
<svg class="octicon octicon-eye v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.06 2C3 2 0 8 0 8s3 6 8.06 6C13 14 16 8 16 8s-3-6-7.94-6zM8 12c-2.2 0-4-1.78-4-4 0-2.2 1.8-4 4-4 2.22 0 4 1.8 4 4 0 2.22-1.78 4-4 4zm2-4c0 1.11-.89 2-2 2-1.11 0-2-.89-2-2 0-1.11.89-2 2-2 1.11 0 2 .89 2 2z"/></svg>
Unwatch releases
</span>
</div>
</button>
<button type="submit" name="do" value="subscribed" class="select-menu-item width-full" aria-checked="false" role="menuitemradio">
<svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg>
<div class="select-menu-item-text">
<span class="select-menu-item-heading">Watching</span>
<span class="description">Be notified of all conversations.</span>
<span class="hidden-select-button-text" data-menu-button-contents>
<svg class="octicon octicon-eye v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8.06 2C3 2 0 8 0 8s3 6 8.06 6C13 14 16 8 16 8s-3-6-7.94-6zM8 12c-2.2 0-4-1.78-4-4 0-2.2 1.8-4 4-4 2.22 0 4 1.8 4 4 0 2.22-1.78 4-4 4zm2-4c0 1.11-.89 2-2 2-1.11 0-2-.89-2-2 0-1.11.89-2 2-2 1.11 0 2 .89 2 2z"/></svg>
Unwatch
</span>
</div>
</button>
<button type="submit" name="do" value="ignore" class="select-menu-item width-full" aria-checked="false" role="menuitemradio">
<svg class="octicon octicon-check select-menu-item-icon" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M12 5l-8 8-4-4 1.5-1.5L4 10l6.5-6.5L12 5z"/></svg>
<div class="select-menu-item-text">
<span class="select-menu-item-heading">Ignoring</span>
<span class="description">Never be notified.</span>
<span class="hidden-select-button-text" data-menu-button-contents>
<svg class="octicon octicon-mute v-align-text-bottom" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M8 2.81v10.38c0 .67-.81 1-1.28.53L3 10H1c-.55 0-1-.45-1-1V7c0-.55.45-1 1-1h2l3.72-3.72C7.19 1.81 8 2.14 8 2.81zm7.53 3.22l-1.06-1.06-1.97 1.97-1.97-1.97-1.06 1.06L11.44 8 9.47 9.97l1.06 1.06 1.97-1.97 1.97 1.97 1.06-1.06L13.56 8l1.97-1.97z"/></svg>
Stop ignoring
</span>
</div>
</button>
</div>
</details-menu>
</details>
<a class="social-count js-social-count"
href="/MicrosoftDocs/azure-docs-pr/watchers"
aria-label="48 users are watching this repository">
48
</a>
<a href="/MicrosoftDocs/azure-docs-pr/network/members" class="social-count"
aria-label="1484 users forked this repository">
1,484
</a>
<h1 class="private ">
MicrosoftDocs/azure-docs-pr Private
</div>
<span itemscope itemtype="http://schema.org/ListItem" itemprop="itemListElement">
<a itemprop="url" data-hotkey="g i" class="js-selected-navigation-item reponav-item" data-selected-links="repo_issues repo_labels repo_milestones /MicrosoftDocs/azure-docs-pr/issues" href="/MicrosoftDocs/azure-docs-pr/issues">
<svg class="octicon octicon-issue-opened" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"/></svg>
<span itemprop="name">Issues</span>
<span class="Counter">24</span>
<meta itemprop="position" content="2">
Pull requests 510
<a data-hotkey="g b" class="js-selected-navigation-item reponav-item" data-selected-links="repo_projects new_repo_project repo_project /MicrosoftDocs/azure-docs-pr/projects" href="/MicrosoftDocs/azure-docs-pr/projects">
<svg class="octicon octicon-project" viewBox="0 0 15 16" version="1.1" width="15" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M10 12h3V2h-3v10zm-4-2h3V2H6v8zm-4 4h3V2H2v12zm-1 1h13V1H1v14zM14 0H1a1 1 0 0 0-1 1v14a1 1 0 0 0 1 1h13a1 1 0 0 0 1-1V1a1 1 0 0 0-1-1z"/></svg>
Projects
<span class="Counter" >1</span>
<a class="js-selected-navigation-item reponav-item" data-selected-links="repo_graphs repo_contributors dependency_graph pulse alerts security people /MicrosoftDocs/azure-docs-pr/pulse" href="/MicrosoftDocs/azure-docs-pr/pulse">
<svg class="octicon octicon-graph" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M16 14v1H0V0h1v14h15zM5 13H3V8h2v5zm4 0H7V3h2v10zm4 0h-2V6h2v7z"/></svg>
Insights
<a class="d-none js-permalink-shortcut" data-hotkey="y" href="/MicrosoftDocs/azure-docs-pr/blob/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services/Face/Face-API-How-to-Topics/specify-recognition-model.md">Permalink</a>
<!-- blob contrib key: blob_contributors:v21:b9d8bb0fcd5b7ba53ba9e5cbe5439691 -->
<div class="file-navigation">
title="Switch branches or tags">
<i>Tree:</i>
<span class="css-truncate-target">db02cb3905</span>
<div class="BtnGroup float-right">
<a href="/MicrosoftDocs/azure-docs-pr/find/db02cb39050636f33a36e6e7fc9b20e9ebb225c6"
class="js-pjax-capture-input btn btn-sm BtnGroup-item"
data-pjax
data-hotkey="t">
Find file
</a>
<clipboard-copy for="blob-path" class="btn btn-sm BtnGroup-item">
Copy path
</clipboard-copy>
</div>
<div id="blob-path" class="breadcrumb">
<span class="repo-root js-repo-root"><span class="js-path-segment"><a data-pjax="true" rel="nofollow" href="/MicrosoftDocs/azure-docs-pr/tree/db02cb39050636f33a36e6e7fc9b20e9ebb225c6"><span>azure-docs-pr</span></a></span></span><span class="separator">/</span><span class="js-path-segment"><a data-pjax="true" rel="nofollow" href="/MicrosoftDocs/azure-docs-pr/tree/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles"><span>articles</span></a></span><span class="separator">/</span><span class="js-path-segment"><a data-pjax="true" rel="nofollow" href="/MicrosoftDocs/azure-docs-pr/tree/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services"><span>cognitive-services</span></a></span><span class="separator">/</span><span class="js-path-segment"><a data-pjax="true" rel="nofollow" href="/MicrosoftDocs/azure-docs-pr/tree/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services/Face"><span>Face</span></a></span><span class="separator">/</span><span class="js-path-segment"><a data-pjax="true" rel="nofollow" href="/MicrosoftDocs/azure-docs-pr/tree/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services/Face/Face-API-How-to-Topics"><span>Face-API-How-to-Topics</span></a></span><span class="separator">/</span><strong class="final-path">specify-recognition-model.md</strong>
</div>
</div>
PatrickFarley
update behavior
db02cb3
<div class="commit-tease-contributors flex-auto">
>
<span><strong>1</strong> recent contributor</span>
<ul class="list-style-none overflow-auto">
<li class="Box-row">
<a class="link-gray-dark no-underline" href="/PatrickFarley">
<img class="avatar mr-2" alt="" src="https://avatars1.githubusercontent.com/u/12807613?s=40&v=4" width="20" height="20" />
PatrickFarley
</div>
<div class="file ">
110 lines (74 sloc)
6.9 KB
<div class="BtnGroup">
<a id="raw-url" class="btn btn-sm BtnGroup-item" href="/MicrosoftDocs/azure-docs-pr/raw/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services/Face/Face-API-How-to-Topics/specify-recognition-model.md">Raw</a>
<a class="btn btn-sm js-update-url-with-hash BtnGroup-item" data-hotkey="b" href="/MicrosoftDocs/azure-docs-pr/blame/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services/Face/Face-API-How-to-Topics/specify-recognition-model.md">Blame</a>
<a rel="nofollow" class="btn btn-sm BtnGroup-item" href="/MicrosoftDocs/azure-docs-pr/commits/db02cb39050636f33a36e6e7fc9b20e9ebb225c6/articles/cognitive-services/Face/Face-API-How-to-Topics/specify-recognition-model.md">History</a>
</div>
<div>
<button class="btn-octicon disabled tooltipped tooltipped-nw "
type="button"
disabled
aria-label="You must be on a branch to open this file in GitHub Desktop">
<svg class="octicon octicon-device-desktop" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M15 2H1c-.55 0-1 .45-1 1v9c0 .55.45 1 1 1h5.34c-.25.61-.86 1.39-2.34 2h8c-1.48-.61-2.09-1.39-2.34-2H15c.55 0 1-.45 1-1V3c0-.55-.45-1-1-1zm0 9H1V3h14v8z"/></svg>
</button>
<button type="button" class="btn-octicon disabled tooltipped tooltipped-nw"
aria-label="You must be on a branch to make or propose changes to this file">
<svg class="octicon octicon-pencil" viewBox="0 0 14 16" version="1.1" width="14" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M0 12v3h3l8-8-3-3-8 8zm3 2H1v-2h1v1h1v1zm10.3-9.3L12 6 9 3l1.3-1.3a.996.996 0 0 1 1.41 0l1.59 1.59c.39.39.39 1.02 0 1.41z"/></svg>
</button>
<button type="button" class="btn-octicon btn-octicon-danger disabled tooltipped tooltipped-nw"
aria-label="You must be on a branch to make or propose changes to this file">
<svg class="octicon octicon-trashcan" viewBox="0 0 12 16" version="1.1" width="12" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M11 2H9c0-.55-.45-1-1-1H5c-.55 0-1 .45-1 1H2c-.55 0-1 .45-1 1v1c0 .55.45 1 1 1v9c0 .55.45 1 1 1h7c.55 0 1-.45 1-1V5c.55 0 1-.45 1-1V3c0-.55-.45-1-1-1zm-1 12H3V5h1v8h1V5h1v8h1V5h1v8h1V5h1v9zm1-10H2V3h9v1z"/></svg>
</button>
</div>
| title | titleSuffix | description | services | author | manager | ms.service | ms.component | ms.topic | ms.date | ms.author |
|---|---|---|---|---|---|---|---|---|---|---|
How to specify a recognition model - Face API |
Azure Cognitive Services |
This article will show you how to choose which recognition model to use with your Azure Face API application. |
cognitive-services |
longl |
nitinme |
cognitive-services |
face-api |
conceptual |
01/14/2019 |
longl |
This guide demonstrates how to specify a face recognition model for face detection, identification and similarity search using the Azure Face API.
The Face API uses deep learning models to perform operations on human faces in images. We continue to improve the accuracy of our models based on customer feedback and advances in deep learning research, and we deliver these improvements as model updates. Developers have the option to specify which version of face recognition model they'd like to use; they can choose the model that best fits their use case.
If you are a new user, we recommend you use the latest model. Read on to learn how to specify it in different Face operations. If you are an advanced user and are not sure whether you should switch to the latest model, skip to the Evaluate different models section to evaluate the new model and compare results using your current data set.
You should be familiar with the concepts of AI face detection and identification. If you aren't, see these how-to guides first:
Face detection identifies the visual landmarks of human faces and finds their bounding-box locations. It also extracts the face's features and stores them for use in identification. All of this information forms the representation of one face.
The recognition model is used when the face features are extracted, so you can specify a model version when performing the Detect operation.
When using the Face - Detect API, assign the model version with the recognitionModel parameter.
Available values:
recognition_v01recognition_v02
So, a request URL for the Face - Detect API will look like this:
https://westus.api.cognitive.microsoft.com/face/v1.0/detect[?returnFaceId][&returnFaceLandmarks][&returnFaceAttributes][&recognitionModel]
&subscription-key=<Subscription key>
If you are using the client library, you can assign the value for recognitionModel by passing a string representing the version.
If you leave it unassigned, the default model version (recognition_v01) will be used.
string imageUrl = "http://news.microsoft.com/ceo/assets/photos/06_web.jpg"; var faces = await faceServiceClient.DetectAsync(imageUrl, true, true, "recognition_v02");
When the Face API extracts face feature data from an image, the service builds a PersonGroup object for person identification.
A PersonGroup should have one unique recognition model for all of the Persons, and you can specify this using the recognitionModelType parameter when you create the group (PersonGroup - Create or LargePersonGroup - Create).
See the following code example for the .NET client library.
// Create an empty PersonGroup with "recognition_v02" model string personGroupId = "myfriends"; await faceServiceClient.CreatePersonGroupAsync(personGroupId, "My Friends", "recognition_v02");
In this code, a PersonGroup with id myfriends is created, and it is set up to use the new recognition_v02 model to extract face features.
Correspondingly, you need to specify which model to use when identifying faces against this PersonGroup (through the Face - Detect API). The model you use should always be consistent with the PersonGroup's configuration; otherwise, the operation will fail due to incompatible models.
There is no change in the Face - Identify API; you only specify the model version in detection.
You can also specify a recognition model for similarity search. You can assign the model version with recognitionModel when creating the face list with FaceList - Create API or LargeFaceList - Create.
See the following code example for the .NET client library.
await faceServiceClient.CreateFaceListAsync(faceListId, "My face collection", "recognition_v02");
This code creates a face list called My face collection, using the recognition_v02 model for feature extraction. So, when you search for similar faces in this face list with a faceId, that faceId's corresponding face should also be detected with the Face - Detect API using recognition_v02. As in the previous section, the model needs to be consistent.
There is no change in the Face - Find Similar API; you only specify the model version in detection.
If you'd like to compare the performances of the recognition_v01 and recognition_v02 models on your data, you will need to:
- Create two PersonGroups with recognition_v01 and recognition_v02 respectively.
- Use your image data to detect faces and register them to Persons for these two PersonGroups, and trigger the training process with PersonGroup - Train API.
- Test with Face - Identify on both PersonGroups and compare the results.
If you normally specify a confidence threshold (a value between zero and one that determines how confident the model must be to identify a face), note that you may need to use different thresholds for different models. A threshold for one model is not meant to be shared to another and will not necessarily produce the same results.
</div>
Go
</main>
<a aria-label="Homepage" title="GitHub" class="footer-octicon mr-lg-4" href="https://github.com">
<svg height="24" class="octicon octicon-mark-github" viewBox="0 0 16 16" version="1.1" width="24" aria-hidden="true"><path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"/></svg>
You can’t perform that action at this time.
<script crossorigin="anonymous" integrity="sha512-dHMBA6mZWk9uDWtzneWOaLZo+E44XFOyEe+RquW3xaTXLDipcQYvXtS+ZyiLwh028R9IKzfjTRhpSlJ/VZDQEw==" type="application/javascript" src="https://github.githubassets.com/assets/frameworks-b740280fb3fd0216.js"></script>
<script crossorigin="anonymous" async="async" integrity="sha512-mXCwr170Nygf2n/n0RYuvFwUV7DT8dyZj5WKqNN/bNkbxetu/kCgXtmtD0IBrFUGjHhl1JTm9Cn2iQAJZ+8DGQ==" type="application/javascript" src="https://github.githubassets.com/assets/github-bootstrap-10ed91b24505a967.js"></script>
You signed in with another tab or window. Reload to refresh your session.
You signed out in another tab or window. Reload to refresh your session.