Analyze - Image

Referentie

Service:: Azure AI Services

API-versie:: 2024-02-01

Analyseer de invoerafbeelding. De aanvraag bevat een afbeeldingsstroom met een inhoudstype ['image/*', 'application/octet-stream'] of een JSON-nettolading met een URL-eigenschap die moet worden gebruikt om de afbeeldingsstroom op te halen.

POST /imageanalysis:analyze?api-version=2024-02-01

Met optionele parameters:

POST /imageanalysis:analyze?features={features}&language={language}&model-version={model-version}&smartcrops-aspect-ratios={smartcrops-aspect-ratios}&gender-neutral-caption={gender-neutral-caption}&api-version=2024-02-01

URI-parameters

Name	In	Vereist	Type	Description
api-version	query	True	string	Aangevraagde API-versie.
features	query		VisualFeature[]	De aangevraagde visuele functies. Er moet ten minste één visuele functie worden opgegeven.
gender-neutral-caption	query		boolean	Booleaanse vlag voor het inschakelen van genderneutrale ondertiteling voor bijschriften en denseCaptions-functies. Als deze parameter niet is opgegeven, is de standaardwaarde 'false'.
language	query		string	De gewenste taal voor het genereren van uitvoer. Als deze parameter niet is opgegeven, is de standaardwaarde 'en'. Zie https://aka.ms/cv-languages voor een lijst met ondersteunde talen.
model-version	query		string	Modelversie.
smartcrops-aspect-ratios	query		array[]	Een lijst met hoogte-breedteverhoudingen die moeten worden gebruikt voor de smartCrops-functie. Hoogte-breedteverhoudingen worden berekend door de breedte van de doelsnijding te delen door de hoogte. Ondersteunde waarden liggen tussen 0,75 en 1,8 (inclusief). Meerdere waarden moeten door komma's worden gescheiden. Als deze parameter niet is opgegeven, retourneert de service één bijsnijdsuggesties met een hoogte-breedteverhouding tussen 0,5 en 2,0 (inclusief).

Aanvraagbody

Name	Vereist	Type	Description
url	True	string	Openbaar bereikbare URL van een afbeelding.

Antwoorden

Name	Type	Description
200 OK	ImageAnalysisResult	Geslaagd
Other Status Codes	ErrorResponse	Fout Kopteksten x-ms-error-code: string

Name

Type

Description

200 OK

ImageAnalysisResult

Geslaagd

Other Status Codes

ErrorResponse

Fout

Kopteksten

x-ms-error-code: string

Voorbeelden

ImageAnalysis_Analyze_MaximumSet_Gen

ImageAnalysis_Analyze_MinimumSet_Gen

ImageAnalysis_Analyze_MaximumSet_Gen

Voorbeeldaanvraag

HTTP

POST /imageanalysis:analyze?features=tags&language=hduryxtlvjjvwnmpjiojibvjy&model-version=kkblitshktun&smartcrops-aspect-ratios=&gender-neutral-caption=True&api-version=2024-02-01

{
  "url": "https://microsoft.com/a"
}

Voorbeeldrespons

Statuscode:: 200

{
  "captionResult": {
    "text": "azcggjzjuvbytsq",
    "confidence": 0
  },
  "objectsResult": {
    "values": [
      {
        "id": "iaofvdltgfjrsffgltupmo",
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 27,
          "h": 13
        },
        "tags": [
          {
            "name": "expoctetvqe",
            "confidence": 0
          }
        ]
      }
    ]
  },
  "readResult": {
    "blocks": [
      {
        "lines": [
          {
            "text": "npk",
            "boundingPolygon": [
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              }
            ],
            "words": [
              {
                "text": "wljuxeeadklupdpxgcinka",
                "boundingPolygon": [
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  }
                ],
                "confidence": 0
              }
            ]
          }
        ]
      }
    ]
  },
  "denseCaptionsResult": {
    "values": [
      {
        "text": "pqrcyrtz",
        "confidence": 0,
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 27,
          "h": 13
        }
      }
    ]
  },
  "modelVersion": "hslbdtpcuyabri",
  "metadata": {
    "width": 10,
    "height": 27
  },
  "tagsResult": {
    "values": [
      {
        "name": "expoctetvqe",
        "confidence": 0
      }
    ]
  },
  "smartCropsResult": {
    "values": [
      {
        "aspectRatio": 23,
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 27,
          "h": 13
        }
      }
    ]
  },
  "peopleResult": {
    "values": [
      {
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 27,
          "h": 13
        },
        "confidence": 0
      }
    ]
  }
}

ImageAnalysis_Analyze_MinimumSet_Gen

Voorbeeldaanvraag

HTTP

POST /imageanalysis:analyze?api-version=2024-02-01

{
  "url": "https://www.abc.com"
}

Voorbeeldrespons

Statuscode:: 200

{
  "modelVersion": "cvhbhwpfswz",
  "metadata": {
    "width": 10,
    "height": 23
  }
}

Definities

Name	Description
BoundingBox	Een begrenzingsvak voor een gebied in een afbeelding.
CaptionResult	Een korte beschrijving van wat de afbeelding weergeeft.
ContentTag	Een entiteitsobservatie in de afbeelding, samen met de betrouwbaarheidsscore.
CropRegion	Een regio die is geïdentificeerd voor slim bijsnijden. Er wordt één regio geretourneerd voor elke aangevraagde hoogte-breedteverhouding.
DenseCaption	Een korte beschrijving van wat de afbeelding weergeeft.
DenseCaptionsResult	Een lijst met bijschriften.
DetectedObject	Beschrijft een gedetecteerd object in een afbeelding.
DetectedPerson	Een persoon gedetecteerd in een afbeelding.
DetectedTextBlock	Een gedetecteerd tekstblok.
DetectedTextLine	Een gedetecteerde tekstregel.
DetectedTextWord	Een gedetecteerd woord dat bestaat uit een aaneengesloten reeks tekens. Voor niet-spaties gescheiden talen, zoals Chinees, Japans en Koreaans, wordt elk teken weergegeven als een eigen woord.
ErrorResponse	Antwoord geretourneerd wanneer er een fout optreedt.
ErrorResponseDetails	Foutgegevens.
ErrorResponseInnerError	Gedetailleerde fout.
ImageAnalysisResult	Beschrijf de gecombineerde resultaten van verschillende typen afbeeldingsanalyse.
ImageMetadata	De metagegevens van de afbeelding, zoals hoogte en breedte.
ImagePoint	Een object dat een punt in de afbeelding vertegenwoordigt.
ImageUrl	Een JSON-document met een URL die verwijst naar de openbaar toegankelijke afbeelding die moet worden geanalyseerd.
ObjectsResult	Hierin worden gedetecteerde objecten in een afbeelding beschreven.
PeopleResult	Een object dat beschrijft of de afbeelding personen bevat.
ReadResult	De resultaten van een leesbewerking.
SmartCropsResult	Resultaat van slim bijsnijden.
TagsResult	Een lijst met tags met een betrouwbaarheidsniveau.
VisualFeature	De aangevraagde visuele functies. Er moet ten minste één visuele functie worden opgegeven.

BoundingBox

Een begrenzingsvak voor een gebied in een afbeelding.

Name	Type	Description
h	integer	Hoogte gemeten vanaf het punt linksboven in het gebied, in pixels.
w	integer	Breedte gemeten vanaf de linkerbovenhoek van het gebied, in pixels.
x	integer	Linkercoördinaat van het linkerbovenhoek van het gebied, in pixels.
y	integer	Bovenste coördinaat van het punt linksboven in het gebied, in pixels.

CaptionResult

Een korte beschrijving van wat de afbeelding weergeeft.

Name	Type	Description
confidence	number	Het betrouwbaarheidsniveau van de service in het bijschrift. Betrouwbaarheidsscores omvatten het bereik van 0,0 tot 1,0 (inclusief), met hogere waarden die een hogere betrouwbaarheid van een overeenkomst aangeven.
text	string	De tekst van het bijschrift.

ContentTag

Een entiteitsobservatie in de afbeelding, samen met de betrouwbaarheidsscore.

Name	Type	Description
confidence	number	Het betrouwbaarheidsniveau dat de entiteit is waargenomen. Betrouwbaarheidsscores omvatten het bereik van 0,0 tot 1,0 (inclusief), met hogere waarden die een hogere betrouwbaarheid van een overeenkomst aangeven.
name	string	Naam van de entiteit.

CropRegion

Een regio die is geïdentificeerd voor slim bijsnijden. Er wordt één regio geretourneerd voor elke aangevraagde hoogte-breedteverhouding.

Name	Type	Description
aspectRatio	number	De hoogte-breedteverhouding van het bijsnijdgebied.
boundingBox	BoundingBox	Een begrenzingsvak voor een gebied in een afbeelding.

DenseCaption

Een korte beschrijving van wat de afbeelding weergeeft.

Name	Type	Description
boundingBox	BoundingBox	Een begrenzingsvak voor een gebied in een afbeelding.
confidence	number	Het betrouwbaarheidsniveau van de service in het bijschrift. Betrouwbaarheidsscores omvatten het bereik van 0,0 tot 1,0 (inclusief), met hogere waarden die een hogere betrouwbaarheid van een overeenkomst aangeven.
text	string	De tekst van het bijschrift.

DenseCaptionsResult

Een lijst met bijschriften.

Name	Type	Description
values	DenseCaption[]	Een lijst met bijschriften.

DetectedObject

Beschrijft een gedetecteerd object in een afbeelding.

Name	Type	Description
boundingBox	BoundingBox	Een begrenzingsvak voor een gebied in een afbeelding.
id	string	Id van het gedetecteerde object.
tags	ContentTag[]	Classificatievertrouwen van het gedetecteerde object.

DetectedPerson

Een persoon gedetecteerd in een afbeelding.

Name	Type	Description
boundingBox	BoundingBox	Een begrenzingsvak voor een gebied in een afbeelding.
confidence	number	Betrouwbaarheidsscore van het observeren van de persoon in de afbeelding. Betrouwbaarheidsscores omvatten het bereik van 0,0 tot 1,0 (inclusief), met hogere waarden die een hogere betrouwbaarheid van een overeenkomst aangeven.

DetectedTextBlock

Een gedetecteerd tekstblok.

Name	Type	Description
lines	DetectedTextLine[]	Lijst met tekstregels in het tekstblok.

DetectedTextLine

Een gedetecteerde tekstregel.

Name	Type	Description
boundingPolygon	ImagePoint[]	Begrenzing veelhoek van de tekstregel.
text	string	Tekstinhoud van de gedetecteerde tekstregel.
words	DetectedTextWord[]	Lijst met woorden in de tekstregel.

DetectedTextWord

Een gedetecteerd woord dat bestaat uit een aaneengesloten reeks tekens. Voor niet-spaties gescheiden talen, zoals Chinees, Japans en Koreaans, wordt elk teken weergegeven als een eigen woord.

Name	Type	Description
boundingPolygon	ImagePoint[]	Begrenzing veelhoek van het woord.
confidence	number	Het betrouwbaarheidsniveau dat het woord is gedetecteerd. Betrouwbaarheidsscores omvatten het bereik van 0,0 tot 1,0 (inclusief), met hogere waarden die een hogere betrouwbaarheid van een overeenkomst aangeven.
text	string	Tekstinhoud van het woord.

ErrorResponse

Antwoord geretourneerd wanneer er een fout optreedt.

Name	Type	Description
error	ErrorResponseDetails	Foutgegevens.

ErrorResponseDetails

Foutgegevens.

Name	Type	Description
code	string	Foutcode.
details	ErrorResponseDetails[]	Lijst met gedetailleerde fouten.
innererror	ErrorResponseInnerError	Gedetailleerde fout.
message	string	Foutbericht.
target	string	Doel van de fout.

ErrorResponseInnerError

Gedetailleerde fout.

Name	Type	Description
code	string	Foutcode.
innererror	ErrorResponseInnerError	Gedetailleerde fout.
message	string	Foutbericht.

ImageAnalysisResult

Beschrijf de gecombineerde resultaten van verschillende typen afbeeldingsanalyse.

Name	Type	Description
captionResult	CaptionResult	Een korte beschrijving van wat de afbeelding weergeeft.
denseCaptionsResult	DenseCaptionsResult	Een lijst met bijschriften.
metadata	ImageMetadata	De metagegevens van de afbeelding, zoals hoogte en breedte.
modelVersion	string	Modelversie.
objectsResult	ObjectsResult	Hierin worden gedetecteerde objecten in een afbeelding beschreven.
peopleResult	PeopleResult	Een object dat beschrijft of de afbeelding personen bevat.
readResult	ReadResult	De resultaten van een leesbewerking.
smartCropsResult	SmartCropsResult	Resultaat van slim bijsnijden.
tagsResult	TagsResult	Een lijst met tags met een betrouwbaarheidsniveau.

ImageMetadata

De metagegevens van de afbeelding, zoals hoogte en breedte.

Name	Type	Description
height	integer	De hoogte van de afbeelding in pixels.
width	integer	De breedte van de afbeelding in pixels.

ImagePoint

Een object dat een punt in de afbeelding vertegenwoordigt.

Name	Type	Description
x	integer	De x-coördinaat van dit punt.
y	integer	De y-coördinaat van dit punt.

ImageUrl

Een JSON-document met een URL die verwijst naar de openbaar toegankelijke afbeelding die moet worden geanalyseerd.

Name	Type	Description
url	string	Openbaar bereikbare URL van een afbeelding.

ObjectsResult

Hierin worden gedetecteerde objecten in een afbeelding beschreven.

Name	Type	Description
values	DetectedObject[]	Een matrix met gedetecteerde objecten.

PeopleResult

Een object dat beschrijft of de afbeelding personen bevat.

Name	Type	Description
values	DetectedPerson[]	Een matrix van gedetecteerde personen.

ReadResult

De resultaten van een leesbewerking.

Name	Type	Description
blocks	DetectedTextBlock[]	Een lijst met tekstblokken.

SmartCropsResult

Resultaat van slim bijsnijden.

Name	Type	Description
values	CropRegion[]	Aanbevolen regio's voor het bijsnijden van de afbeelding.

TagsResult

Een lijst met tags met een betrouwbaarheidsniveau.

Name	Type	Description
values	ContentTag[]	Een lijst met tags met een betrouwbaarheidsniveau.

VisualFeature

De aangevraagde visuele functies. Er moet ten minste één visuele functie worden opgegeven.

Name	Type	Description
caption	string	Een beschrijving of bijschrift die de inhoud van de afbeelding samenvat.
denseCaptions	string	Gedetailleerde bijschriften met gedetailleerde beschrijvingen van de inhoud van de afbeelding.
objects	string	Specifieke objecten die in de afbeelding worden herkend en gelabeld.
people	string	Detectie en analyse van personen in de afbeelding.
read	string	Tekstuele inhoud geëxtraheerd uit de afbeelding, zoals tekens of labels.
smartCrops	string	Automatisch gegenereerde bijgesneden versies van de afbeelding die zijn gericht op belangrijke inhoud.
tags	string	Visuele tags die objecten vertegenwoordigen die in de afbeelding zijn gedetecteerd.

Delen via

Analyze - Image

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

ImageAnalysis_Analyze_MaximumSet_Gen

Voorbeeldaanvraag

Voorbeeldrespons

ImageAnalysis_Analyze_MinimumSet_Gen

Voorbeeldaanvraag

Voorbeeldrespons

Definities

BoundingBox

CaptionResult

ContentTag

CropRegion

DenseCaption

DenseCaptionsResult

DetectedObject

DetectedPerson

DetectedTextBlock

DetectedTextLine

DetectedTextWord

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

ImageAnalysisResult

ImageMetadata

ImagePoint

ImageUrl

ObjectsResult

PeopleResult

ReadResult

SmartCropsResult

TagsResult

VisualFeature

Aanvullende resources