共用方式為

DetectFromUrl interface

套件:
@azure-rest/ai-vision-face

方法

post(DetectFromSessionImageIdParameters)

重要

Microsoft已淘汰或有限的面部辨識功能，可以用來推斷情感狀態和身份屬性，如果濫用，可能會使人們受到陳規定型觀念、歧視或不公平的拒絕服務。 已淘汰的功能是情感和性別。 有限的能力是年齡，微笑，面部頭髮，頭髮和化妝。 如果您有負責任的使用案例，可受益於使用任何有限功能，則電子郵件 Azure Face API。 如需此決定的詳細資訊，請參閱這裡。

    • 不會儲存任何映像。 只會將擷取的臉部功能儲存在伺服器上。 faceId 是臉部功能的標識碼，將用於「識別」、「驗證」和「尋找類似專案」。 儲存的臉部功能將會過期，並在原始偵測呼叫之後由faceIdTimeToLive指定的時間刪除。
    • 選擇性參數包括faceId、地標和屬性。 屬性包括 headPose、眼鏡、遮蔽、配件、模糊、曝光、噪音、遮罩和品質ForRecognition。 針對特定屬性傳回的部分結果可能不精確。
    • 支援 JPEG、PNG、GIF（第一個畫面格）和 BMP 格式。 允許的映像檔大小從 1KB 到 6MB。
    • 影像中可偵測到的臉部大小下限為 36x36 像素，不大於 1920x1080 圖元。 維度高於 1920x1080 像素的影像需要比例較大的最小臉部大小。
    • 最多可以針對影像傳回 100 張臉部。 臉部會依從大到小的臉部矩形大小進行排名。
    • 如需查詢「識別」、「驗證」和「尋找類似專案」（『returnFaceId』 為 true）的最佳結果，請使用正面、清晰且大小下限為 200x200 像素（眼睛之間的 100 像素）。
    • 您可以提供不同的 'detectionModel' 值。 地標和支援屬性的可用性取決於指定的偵測模型。 若要使用和比較不同的偵測模型，請參閱這裡 。
    • 提供不同的 'recognitionModel' 值。 如果需要「驗證」、「識別」、「尋找類似專案」等後續作業，請使用 『recognitionModel』 參數來指定辨識模型。 'recognitionModel' 的預設值為 'recognition_01'，如果需要最新的模型，請明確指定此參數中所需的模型。 指定之後，偵測到的faceIds將會與指定的辨識模型相關聯。 如需詳細資訊，請參閱這裡。
post(DetectFromUrlParameters)

重要

Microsoft已淘汰或有限的面部辨識功能，可以用來推斷情感狀態和身份屬性，如果濫用，可能會使人們受到陳規定型觀念、歧視或不公平的拒絕服務。 已淘汰的功能是情感和性別。 有限的能力是年齡，微笑，面部頭髮，頭髮和化妝。 如果您有負責任的使用案例，可受益於使用任何有限功能，則電子郵件 Azure Face API。 如需此決定的詳細資訊，請參閱這裡。

    • 不會儲存任何映像。 只會將擷取的臉部功能儲存在伺服器上。 faceId 是臉部功能的標識碼，將用於「識別」、「驗證」和「尋找類似專案」。 儲存的臉部功能將會過期，並在原始偵測呼叫之後由faceIdTimeToLive指定的時間刪除。
    • 選擇性參數包括faceId、地標和屬性。 屬性包括 headPose、眼鏡、遮蔽、配件、模糊、曝光、噪音、遮罩和品質ForRecognition。 針對特定屬性傳回的部分結果可能不精確。
    • 支援 JPEG、PNG、GIF（第一個畫面格）和 BMP 格式。 允許的映像檔大小從 1KB 到 6MB。
    • 影像中可偵測到的臉部大小下限為 36x36 像素，不大於 1920x1080 圖元。 維度高於 1920x1080 像素的影像需要比例較大的最小臉部大小。
    • 最多可以針對影像傳回 100 張臉部。 臉部會依從大到小的臉部矩形大小進行排名。
    • 如需查詢「識別」、「驗證」和「尋找類似專案」（『returnFaceId』 為 true）的最佳結果，請使用正面、清晰且大小下限為 200x200 像素（眼睛之間的 100 像素）。
    • 您可以提供不同的 'detectionModel' 值。 地標和支援屬性的可用性取決於指定的偵測模型。 若要使用和比較不同的偵測模型，請參閱這裡 。
    • 提供不同的 'recognitionModel' 值。 如果需要「驗證」、「識別」、「尋找類似專案」等後續作業，請使用 『recognitionModel』 參數來指定辨識模型。 'recognitionModel' 的預設值為 'recognition_01'，如果需要最新的模型，請明確指定此參數中所需的模型。 指定之後，偵測到的faceIds將會與指定的辨識模型相關聯。 如需詳細資訊，請參閱這裡。
post(DetectParameters)

重要

Microsoft已淘汰或有限的面部辨識功能，可以用來推斷情感狀態和身份屬性，如果濫用，可能會使人們受到陳規定型觀念、歧視或不公平的拒絕服務。 已淘汰的功能是情感和性別。 有限的能力是年齡，微笑，面部頭髮，頭髮和化妝。 如果您有負責任的使用案例，可受益於使用任何有限功能，則電子郵件 Azure Face API。 如需此決定的詳細資訊，請參閱這裡。

    • 不會儲存任何映像。 只會將擷取的臉部功能儲存在伺服器上。 faceId 是臉部功能的標識碼，將用於「識別」、「驗證」和「尋找類似專案」。 儲存的臉部功能將會過期，並在原始偵測呼叫之後由faceIdTimeToLive指定的時間刪除。
    • 選擇性參數包括faceId、地標和屬性。 屬性包括 headPose、眼鏡、遮蔽、配件、模糊、曝光、噪音、遮罩和品質ForRecognition。 針對特定屬性傳回的部分結果可能不精確。
    • 支援 JPEG、PNG、GIF（第一個畫面格）和 BMP 格式。 允許的映像檔大小從 1KB 到 6MB。
    • 影像中可偵測到的臉部大小下限為 36x36 像素，不大於 1920x1080 圖元。 維度高於 1920x1080 像素的影像需要比例較大的最小臉部大小。
    • 最多可以針對影像傳回 100 張臉部。 臉部會依從大到小的臉部矩形大小進行排名。
    • 如需查詢「識別」、「驗證」和「尋找類似專案」（『returnFaceId』 為 true）的最佳結果，請使用正面、清晰且大小下限為 200x200 像素（眼睛之間的 100 像素）。
    • 您可以提供不同的 'detectionModel' 值。 地標和支援屬性的可用性取決於指定的偵測模型。 若要使用和比較不同的偵測模型，請參閱這裡 。
    • 提供不同的 'recognitionModel' 值。 如果需要「驗證」、「識別」、「尋找類似專案」等後續作業，請使用 『recognitionModel』 參數來指定辨識模型。 'recognitionModel' 的預設值為 'recognition_01'，如果需要最新的模型，請明確指定此參數中所需的模型。 指定之後，偵測到的faceIds將會與指定的辨識模型相關聯。 如需詳細資訊，請參閱這裡。

方法詳細資料

post(DetectFromSessionImageIdParameters)

重要

Microsoft已淘汰或有限的面部辨識功能，可以用來推斷情感狀態和身份屬性，如果濫用，可能會使人們受到陳規定型觀念、歧視或不公平的拒絕服務。 已淘汰的功能是情感和性別。 有限的能力是年齡，微笑，面部頭髮，頭髮和化妝。 如果您有負責任的使用案例，可受益於使用任何有限功能，則電子郵件 Azure Face API。 如需此決定的詳細資訊，請參閱這裡。

    • 不會儲存任何映像。 只會將擷取的臉部功能儲存在伺服器上。 faceId 是臉部功能的標識碼，將用於「識別」、「驗證」和「尋找類似專案」。 儲存的臉部功能將會過期，並在原始偵測呼叫之後由faceIdTimeToLive指定的時間刪除。
    • 選擇性參數包括faceId、地標和屬性。 屬性包括 headPose、眼鏡、遮蔽、配件、模糊、曝光、噪音、遮罩和品質ForRecognition。 針對特定屬性傳回的部分結果可能不精確。
    • 支援 JPEG、PNG、GIF（第一個畫面格）和 BMP 格式。 允許的映像檔大小從 1KB 到 6MB。
    • 影像中可偵測到的臉部大小下限為 36x36 像素，不大於 1920x1080 圖元。 維度高於 1920x1080 像素的影像需要比例較大的最小臉部大小。
    • 最多可以針對影像傳回 100 張臉部。 臉部會依從大到小的臉部矩形大小進行排名。
    • 如需查詢「識別」、「驗證」和「尋找類似專案」（『returnFaceId』 為 true）的最佳結果，請使用正面、清晰且大小下限為 200x200 像素（眼睛之間的 100 像素）。
    • 您可以提供不同的 'detectionModel' 值。 地標和支援屬性的可用性取決於指定的偵測模型。 若要使用和比較不同的偵測模型，請參閱這裡 。
    • 提供不同的 'recognitionModel' 值。 如果需要「驗證」、「識別」、「尋找類似專案」等後續作業，請使用 『recognitionModel』 參數來指定辨識模型。 'recognitionModel' 的預設值為 'recognition_01'，如果需要最新的模型，請明確指定此參數中所需的模型。 指定之後，偵測到的faceIds將會與指定的辨識模型相關聯。 如需詳細資訊，請參閱這裡。
function post(options: DetectFromSessionImageIdParameters): StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

參數

options
DetectFromSessionImageIdParameters

傳回

StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

post(DetectFromUrlParameters)

重要

Microsoft已淘汰或有限的面部辨識功能，可以用來推斷情感狀態和身份屬性，如果濫用，可能會使人們受到陳規定型觀念、歧視或不公平的拒絕服務。 已淘汰的功能是情感和性別。 有限的能力是年齡，微笑，面部頭髮，頭髮和化妝。 如果您有負責任的使用案例，可受益於使用任何有限功能，則電子郵件 Azure Face API。 如需此決定的詳細資訊，請參閱這裡。

    • 不會儲存任何映像。 只會將擷取的臉部功能儲存在伺服器上。 faceId 是臉部功能的標識碼，將用於「識別」、「驗證」和「尋找類似專案」。 儲存的臉部功能將會過期，並在原始偵測呼叫之後由faceIdTimeToLive指定的時間刪除。
    • 選擇性參數包括faceId、地標和屬性。 屬性包括 headPose、眼鏡、遮蔽、配件、模糊、曝光、噪音、遮罩和品質ForRecognition。 針對特定屬性傳回的部分結果可能不精確。
    • 支援 JPEG、PNG、GIF（第一個畫面格）和 BMP 格式。 允許的映像檔大小從 1KB 到 6MB。
    • 影像中可偵測到的臉部大小下限為 36x36 像素，不大於 1920x1080 圖元。 維度高於 1920x1080 像素的影像需要比例較大的最小臉部大小。
    • 最多可以針對影像傳回 100 張臉部。 臉部會依從大到小的臉部矩形大小進行排名。
    • 如需查詢「識別」、「驗證」和「尋找類似專案」（『returnFaceId』 為 true）的最佳結果，請使用正面、清晰且大小下限為 200x200 像素（眼睛之間的 100 像素）。
    • 您可以提供不同的 'detectionModel' 值。 地標和支援屬性的可用性取決於指定的偵測模型。 若要使用和比較不同的偵測模型，請參閱這裡 。
    • 提供不同的 'recognitionModel' 值。 如果需要「驗證」、「識別」、「尋找類似專案」等後續作業，請使用 『recognitionModel』 參數來指定辨識模型。 'recognitionModel' 的預設值為 'recognition_01'，如果需要最新的模型，請明確指定此參數中所需的模型。 指定之後，偵測到的faceIds將會與指定的辨識模型相關聯。 如需詳細資訊，請參閱這裡。
function post(options: DetectFromUrlParameters): StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

參數

options
DetectFromUrlParameters

傳回

StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

post(DetectParameters)

重要

Microsoft已淘汰或有限的面部辨識功能，可以用來推斷情感狀態和身份屬性，如果濫用，可能會使人們受到陳規定型觀念、歧視或不公平的拒絕服務。 已淘汰的功能是情感和性別。 有限的能力是年齡，微笑，面部頭髮，頭髮和化妝。 如果您有負責任的使用案例，可受益於使用任何有限功能，則電子郵件 Azure Face API。 如需此決定的詳細資訊，請參閱這裡。

    • 不會儲存任何映像。 只會將擷取的臉部功能儲存在伺服器上。 faceId 是臉部功能的標識碼，將用於「識別」、「驗證」和「尋找類似專案」。 儲存的臉部功能將會過期，並在原始偵測呼叫之後由faceIdTimeToLive指定的時間刪除。
    • 選擇性參數包括faceId、地標和屬性。 屬性包括 headPose、眼鏡、遮蔽、配件、模糊、曝光、噪音、遮罩和品質ForRecognition。 針對特定屬性傳回的部分結果可能不精確。
    • 支援 JPEG、PNG、GIF（第一個畫面格）和 BMP 格式。 允許的映像檔大小從 1KB 到 6MB。
    • 影像中可偵測到的臉部大小下限為 36x36 像素，不大於 1920x1080 圖元。 維度高於 1920x1080 像素的影像需要比例較大的最小臉部大小。
    • 最多可以針對影像傳回 100 張臉部。 臉部會依從大到小的臉部矩形大小進行排名。
    • 如需查詢「識別」、「驗證」和「尋找類似專案」（『returnFaceId』 為 true）的最佳結果，請使用正面、清晰且大小下限為 200x200 像素（眼睛之間的 100 像素）。
    • 您可以提供不同的 'detectionModel' 值。 地標和支援屬性的可用性取決於指定的偵測模型。 若要使用和比較不同的偵測模型，請參閱這裡 。
    • 提供不同的 'recognitionModel' 值。 如果需要「驗證」、「識別」、「尋找類似專案」等後續作業，請使用 『recognitionModel』 參數來指定辨識模型。 'recognitionModel' 的預設值為 'recognition_01'，如果需要最新的模型，請明確指定此參數中所需的模型。 指定之後，偵測到的faceIds將會與指定的辨識模型相關聯。 如需詳細資訊，請參閱這裡。
function post(options: DetectParameters): StreamableMethod<Detect200Response | DetectDefaultResponse>

參數

options
DetectParameters

傳回

StreamableMethod<Detect200Response | DetectDefaultResponse>