Udostępnij za pośrednictwem

DetectFromUrl interface

Pakiet:
@azure-rest/ai-vision-face

Metody

post(DetectFromSessionImageIdParameters)

Ważny

Firma Microsoft ma wycofane lub ograniczone możliwości rozpoznawania twarzy, które mogą służyć do wnioskowania stanów emocjonalnych i atrybutów tożsamości, które, w przypadku nieprawidłowego użycia, mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowy usług. Wycofane możliwości to emocje i płeć. Ograniczone możliwości to wiek, uśmiech, zarost, włosy i makijaż. Adres e-mail interfejsu API rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji tutaj.

    • Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze. FaceId jest identyfikatorem funkcji twarzy i będzie używany w elementach "Identify", "Verify" i "Find Similar". Przechowywane funkcje twarzy wygasną i zostaną usunięte w czasie określonym przez faceIdTimeToLive po oryginalnym wywołaniu wykrywania.
    • Parametry opcjonalne obejmują faceId, punkty orientacyjne i atrybuty. Atrybuty obejmują headPose, okulary, okluzji, akcesoria, rozmycie, ekspozycji, hałasu, maski i jakościForRecognition. Niektóre wyniki zwracane dla określonych atrybutów mogą nie być bardzo dokładne.
    • Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
    • Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
    • Dla obrazu można zwrócić maksymalnie 100 twarzy. Twarze są klasyfikowane według rozmiaru prostokąta twarzy od dużych do małych.
    • Aby uzyskać optymalne wyniki podczas wykonywania zapytań dotyczących wartości "Identify", "Verify" i "Find Similar" ('returnFaceId' ma wartość true), użyj twarzy, które są: przednie, jasne i o minimalnym rozmiarze 200x200 pikseli (100 pikseli między oczami).
    • Można podać różne wartości "detectionModel". Dostępność punktów orientacyjnych i obsługiwanych atrybutów zależy od określonego modelu wykrywania. Aby użyć i porównać różne modele wykrywania, zapoznaj się z tutaj.
    • Podano różne wartości "recognitionModel". Jeśli potrzebne są operacje monitowania, takie jak "Verify", "Identify", "Find Similar", określ model rozpoznawania z parametrem "recognitionModel". Wartość domyślna "recognitionModel" to "recognition_01", jeśli jest potrzebny najnowszy model, jawnie określ model, którego potrzebujesz w tym parametrze. Po określeniu wykryte identyfikatory faceId zostaną skojarzone z określonym modelem rozpoznawania. Więcej informacji można znaleźć w tutaj.
post(DetectFromUrlParameters)

Ważny

Firma Microsoft ma wycofane lub ograniczone możliwości rozpoznawania twarzy, które mogą służyć do wnioskowania stanów emocjonalnych i atrybutów tożsamości, które, w przypadku nieprawidłowego użycia, mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowy usług. Wycofane możliwości to emocje i płeć. Ograniczone możliwości to wiek, uśmiech, zarost, włosy i makijaż. Adres e-mail interfejsu API rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji tutaj.

    • Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze. FaceId jest identyfikatorem funkcji twarzy i będzie używany w elementach "Identify", "Verify" i "Find Similar". Przechowywane funkcje twarzy wygasną i zostaną usunięte w czasie określonym przez faceIdTimeToLive po oryginalnym wywołaniu wykrywania.
    • Parametry opcjonalne obejmują faceId, punkty orientacyjne i atrybuty. Atrybuty obejmują headPose, okulary, okluzji, akcesoria, rozmycie, ekspozycji, hałasu, maski i jakościForRecognition. Niektóre wyniki zwracane dla określonych atrybutów mogą nie być bardzo dokładne.
    • Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
    • Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
    • Dla obrazu można zwrócić maksymalnie 100 twarzy. Twarze są klasyfikowane według rozmiaru prostokąta twarzy od dużych do małych.
    • Aby uzyskać optymalne wyniki podczas wykonywania zapytań dotyczących wartości "Identify", "Verify" i "Find Similar" ('returnFaceId' ma wartość true), użyj twarzy, które są: przednie, jasne i o minimalnym rozmiarze 200x200 pikseli (100 pikseli między oczami).
    • Można podać różne wartości "detectionModel". Dostępność punktów orientacyjnych i obsługiwanych atrybutów zależy od określonego modelu wykrywania. Aby użyć i porównać różne modele wykrywania, zapoznaj się z tutaj.
    • Podano różne wartości "recognitionModel". Jeśli potrzebne są operacje monitowania, takie jak "Verify", "Identify", "Find Similar", określ model rozpoznawania z parametrem "recognitionModel". Wartość domyślna "recognitionModel" to "recognition_01", jeśli jest potrzebny najnowszy model, jawnie określ model, którego potrzebujesz w tym parametrze. Po określeniu wykryte identyfikatory faceId zostaną skojarzone z określonym modelem rozpoznawania. Więcej informacji można znaleźć w tutaj.
post(DetectParameters)

Ważny

Firma Microsoft ma wycofane lub ograniczone możliwości rozpoznawania twarzy, które mogą służyć do wnioskowania stanów emocjonalnych i atrybutów tożsamości, które, w przypadku nieprawidłowego użycia, mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowy usług. Wycofane możliwości to emocje i płeć. Ograniczone możliwości to wiek, uśmiech, zarost, włosy i makijaż. Adres e-mail interfejsu API rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji tutaj.

    • Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze. FaceId jest identyfikatorem funkcji twarzy i będzie używany w elementach "Identify", "Verify" i "Find Similar". Przechowywane funkcje twarzy wygasną i zostaną usunięte w czasie określonym przez faceIdTimeToLive po oryginalnym wywołaniu wykrywania.
    • Parametry opcjonalne obejmują faceId, punkty orientacyjne i atrybuty. Atrybuty obejmują headPose, okulary, okluzji, akcesoria, rozmycie, ekspozycji, hałasu, maski i jakościForRecognition. Niektóre wyniki zwracane dla określonych atrybutów mogą nie być bardzo dokładne.
    • Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
    • Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
    • Dla obrazu można zwrócić maksymalnie 100 twarzy. Twarze są klasyfikowane według rozmiaru prostokąta twarzy od dużych do małych.
    • Aby uzyskać optymalne wyniki podczas wykonywania zapytań dotyczących wartości "Identify", "Verify" i "Find Similar" ('returnFaceId' ma wartość true), użyj twarzy, które są: przednie, jasne i o minimalnym rozmiarze 200x200 pikseli (100 pikseli między oczami).
    • Można podać różne wartości "detectionModel". Dostępność punktów orientacyjnych i obsługiwanych atrybutów zależy od określonego modelu wykrywania. Aby użyć i porównać różne modele wykrywania, zapoznaj się z tutaj.
    • Podano różne wartości "recognitionModel". Jeśli potrzebne są operacje monitowania, takie jak "Verify", "Identify", "Find Similar", określ model rozpoznawania z parametrem "recognitionModel". Wartość domyślna "recognitionModel" to "recognition_01", jeśli jest potrzebny najnowszy model, jawnie określ model, którego potrzebujesz w tym parametrze. Po określeniu wykryte identyfikatory faceId zostaną skojarzone z określonym modelem rozpoznawania. Więcej informacji można znaleźć w tutaj.

Szczegóły metody

post(DetectFromSessionImageIdParameters)

Ważny

Firma Microsoft ma wycofane lub ograniczone możliwości rozpoznawania twarzy, które mogą służyć do wnioskowania stanów emocjonalnych i atrybutów tożsamości, które, w przypadku nieprawidłowego użycia, mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowy usług. Wycofane możliwości to emocje i płeć. Ograniczone możliwości to wiek, uśmiech, zarost, włosy i makijaż. Adres e-mail interfejsu API rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji tutaj.

    • Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze. FaceId jest identyfikatorem funkcji twarzy i będzie używany w elementach "Identify", "Verify" i "Find Similar". Przechowywane funkcje twarzy wygasną i zostaną usunięte w czasie określonym przez faceIdTimeToLive po oryginalnym wywołaniu wykrywania.
    • Parametry opcjonalne obejmują faceId, punkty orientacyjne i atrybuty. Atrybuty obejmują headPose, okulary, okluzji, akcesoria, rozmycie, ekspozycji, hałasu, maski i jakościForRecognition. Niektóre wyniki zwracane dla określonych atrybutów mogą nie być bardzo dokładne.
    • Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
    • Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
    • Dla obrazu można zwrócić maksymalnie 100 twarzy. Twarze są klasyfikowane według rozmiaru prostokąta twarzy od dużych do małych.
    • Aby uzyskać optymalne wyniki podczas wykonywania zapytań dotyczących wartości "Identify", "Verify" i "Find Similar" ('returnFaceId' ma wartość true), użyj twarzy, które są: przednie, jasne i o minimalnym rozmiarze 200x200 pikseli (100 pikseli między oczami).
    • Można podać różne wartości "detectionModel". Dostępność punktów orientacyjnych i obsługiwanych atrybutów zależy od określonego modelu wykrywania. Aby użyć i porównać różne modele wykrywania, zapoznaj się z tutaj.
    • Podano różne wartości "recognitionModel". Jeśli potrzebne są operacje monitowania, takie jak "Verify", "Identify", "Find Similar", określ model rozpoznawania z parametrem "recognitionModel". Wartość domyślna "recognitionModel" to "recognition_01", jeśli jest potrzebny najnowszy model, jawnie określ model, którego potrzebujesz w tym parametrze. Po określeniu wykryte identyfikatory faceId zostaną skojarzone z określonym modelem rozpoznawania. Więcej informacji można znaleźć w tutaj.
function post(options: DetectFromSessionImageIdParameters): StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

Parametry

options
DetectFromSessionImageIdParameters

Zwraca

StreamableMethod<DetectFromSessionImageId200Response | DetectFromSessionImageIdDefaultResponse>

post(DetectFromUrlParameters)

Ważny

Firma Microsoft ma wycofane lub ograniczone możliwości rozpoznawania twarzy, które mogą służyć do wnioskowania stanów emocjonalnych i atrybutów tożsamości, które, w przypadku nieprawidłowego użycia, mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowy usług. Wycofane możliwości to emocje i płeć. Ograniczone możliwości to wiek, uśmiech, zarost, włosy i makijaż. Adres e-mail interfejsu API rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji tutaj.

    • Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze. FaceId jest identyfikatorem funkcji twarzy i będzie używany w elementach "Identify", "Verify" i "Find Similar". Przechowywane funkcje twarzy wygasną i zostaną usunięte w czasie określonym przez faceIdTimeToLive po oryginalnym wywołaniu wykrywania.
    • Parametry opcjonalne obejmują faceId, punkty orientacyjne i atrybuty. Atrybuty obejmują headPose, okulary, okluzji, akcesoria, rozmycie, ekspozycji, hałasu, maski i jakościForRecognition. Niektóre wyniki zwracane dla określonych atrybutów mogą nie być bardzo dokładne.
    • Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
    • Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
    • Dla obrazu można zwrócić maksymalnie 100 twarzy. Twarze są klasyfikowane według rozmiaru prostokąta twarzy od dużych do małych.
    • Aby uzyskać optymalne wyniki podczas wykonywania zapytań dotyczących wartości "Identify", "Verify" i "Find Similar" ('returnFaceId' ma wartość true), użyj twarzy, które są: przednie, jasne i o minimalnym rozmiarze 200x200 pikseli (100 pikseli między oczami).
    • Można podać różne wartości "detectionModel". Dostępność punktów orientacyjnych i obsługiwanych atrybutów zależy od określonego modelu wykrywania. Aby użyć i porównać różne modele wykrywania, zapoznaj się z tutaj.
    • Podano różne wartości "recognitionModel". Jeśli potrzebne są operacje monitowania, takie jak "Verify", "Identify", "Find Similar", określ model rozpoznawania z parametrem "recognitionModel". Wartość domyślna "recognitionModel" to "recognition_01", jeśli jest potrzebny najnowszy model, jawnie określ model, którego potrzebujesz w tym parametrze. Po określeniu wykryte identyfikatory faceId zostaną skojarzone z określonym modelem rozpoznawania. Więcej informacji można znaleźć w tutaj.
function post(options: DetectFromUrlParameters): StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

Parametry

options
DetectFromUrlParameters

Zwraca

StreamableMethod<DetectFromUrl200Response | DetectFromUrlDefaultResponse>

post(DetectParameters)

Ważny

Firma Microsoft ma wycofane lub ograniczone możliwości rozpoznawania twarzy, które mogą służyć do wnioskowania stanów emocjonalnych i atrybutów tożsamości, które, w przypadku nieprawidłowego użycia, mogą podlegać stereotypom, dyskryminacji lub niesprawiedliwej odmowy usług. Wycofane możliwości to emocje i płeć. Ograniczone możliwości to wiek, uśmiech, zarost, włosy i makijaż. Adres e-mail interfejsu API rozpoznawania twarzy platformy Azure, jeśli masz odpowiedzialny przypadek użycia, który będzie korzystać z dowolnego z ograniczonych możliwości. Przeczytaj więcej na temat tej decyzji tutaj.

    • Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy będą przechowywane na serwerze. FaceId jest identyfikatorem funkcji twarzy i będzie używany w elementach "Identify", "Verify" i "Find Similar". Przechowywane funkcje twarzy wygasną i zostaną usunięte w czasie określonym przez faceIdTimeToLive po oryginalnym wywołaniu wykrywania.
    • Parametry opcjonalne obejmują faceId, punkty orientacyjne i atrybuty. Atrybuty obejmują headPose, okulary, okluzji, akcesoria, rozmycie, ekspozycji, hałasu, maski i jakościForRecognition. Niektóre wyniki zwracane dla określonych atrybutów mogą nie być bardzo dokładne.
    • Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
    • Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
    • Dla obrazu można zwrócić maksymalnie 100 twarzy. Twarze są klasyfikowane według rozmiaru prostokąta twarzy od dużych do małych.
    • Aby uzyskać optymalne wyniki podczas wykonywania zapytań dotyczących wartości "Identify", "Verify" i "Find Similar" ('returnFaceId' ma wartość true), użyj twarzy, które są: przednie, jasne i o minimalnym rozmiarze 200x200 pikseli (100 pikseli między oczami).
    • Można podać różne wartości "detectionModel". Dostępność punktów orientacyjnych i obsługiwanych atrybutów zależy od określonego modelu wykrywania. Aby użyć i porównać różne modele wykrywania, zapoznaj się z tutaj.
    • Podano różne wartości "recognitionModel". Jeśli potrzebne są operacje monitowania, takie jak "Verify", "Identify", "Find Similar", określ model rozpoznawania z parametrem "recognitionModel". Wartość domyślna "recognitionModel" to "recognition_01", jeśli jest potrzebny najnowszy model, jawnie określ model, którego potrzebujesz w tym parametrze. Po określeniu wykryte identyfikatory faceId zostaną skojarzone z określonym modelem rozpoznawania. Więcej informacji można znaleźć w tutaj.
function post(options: DetectParameters): StreamableMethod<Detect200Response | DetectDefaultResponse>

Parametry

options
DetectParameters

Zwraca

StreamableMethod<Detect200Response | DetectDefaultResponse>