Image Analysis - Segment Image

Service:

Azure AI Services

Version d'API:

2023-04-01-preview

Analysez l’image d’entrée. La requête contient un flux d’image avec n’importe quel type de contenu ['image/*', 'application/octet-stream'] ou une charge utile JSON qui inclut une propriété URL à utiliser pour récupérer le flux d’image. Un flux d’images de type de contenu « image/png » est retourné, où les valeurs de pixels dépendent du mode d’analyse. L’image retournée a les mêmes dimensions que l’image d’entrée pour les modes : foregroundMatting. L’image retournée a les mêmes proportions et les mêmes dimensions que l’image d’entrée jusqu’à une limite de 16 mégapixels pour les modes : backgroundRemoval.

POST /imageanalysis:segment?api-version=2023-04-01-preview

Avec des paramètres facultatifs:

POST /imageanalysis:segment?mode={mode}&api-version=2023-04-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
api-version	query	True	string	Version de l’API demandée.
mode	query		SegmentationMode	Mode d’analyse demandé.

Corps de la demande

Nom	Obligatoire	Type	Description
url	True	string	URL accessible publiquement d’une image.

Réponses

Nom	Type	Description
200 OK	file	Succès Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	Error Media Types: "image/png", "application/json" En-têtes x-ms-error-code: string

Exemples

Segment_BackgroundRemoval_FromImageUrl

Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

Exemple de requête

HTTP

POST /imageanalysis:segment?mode=backgroundRemoval&api-version=2023-04-01-preview

{
  "url": "{image url}"
}

Exemple de réponse

Code d’état:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

Exemple de requête

HTTP

POST /imageanalysis:segment?mode=foregroundMatting&api-version=2023-04-01-preview

{
  "url": "{image url}"
}

Exemple de réponse

Code d’état:

200

"Ynl0ZXM="

Définitions

Nom	Description
ErrorResponse	Réponse retournée lorsqu’une erreur se produit.
ErrorResponseDetails	Informations sur l’erreur.
ErrorResponseInnerError	Erreur détaillée.
ImageUrl	Document JSON avec une URL pointant vers l’image à analyser.
SegmentationMode	Mode d’analyse demandé.

ErrorResponse

Réponse retournée lorsqu’une erreur se produit.

Nom	Type	Description
error	ErrorResponseDetails	Informations sur l’erreur.

ErrorResponseDetails

Informations sur l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
details	ErrorResponseDetails[]	Liste des erreurs détaillées.
innererror	ErrorResponseInnerError	Erreur détaillée.
message	string	Message d’erreur.
target	string	Cible de l’erreur.

ErrorResponseInnerError

Erreur détaillée.

Nom	Type	Description
code	string	Code d’erreur.
innererror	ErrorResponseInnerError	Erreur détaillée.
message	string	Message d’erreur.

ImageUrl

Document JSON avec une URL pointant vers l’image à analyser.

Nom	Type	Description
url	string	URL accessible publiquement d’une image.

SegmentationMode

Mode d’analyse demandé.

Nom	Type	Description
backgroundRemoval	string
foregroundMatting	string