Analyze - Image Stream

Referentie

Service:: Azure AI Services

API-versie:: 2024-02-01

Analyseer de invoerafbeelding. De aanvraag bevat een afbeeldingsstroom met elk inhoudstype ['image/*', 'application/octet-stream'].

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

Met optionele parameters:

POST /imageanalysis:analyze?overload=stream&features={features}&language={language}&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 bijschriften voor bijschrift- 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.
smartcrops-aspect-ratios	query		array[]	Een lijst met hoogte-breedteverhoudingen die moeten worden gebruikt voor de functie SmartCrops. 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 die past tussen 0,5 en 2,0 (inclusief).

Aanvraagbody

Media Types: "application/octet-stream", "image/jpeg", "image/gif", "image/tiff", "image/bmp", "image/png"

Name	Type	Description
body	string (byte)	Een afbeeldingsstroom.

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?overload=stream&features=tags&language=zizuomdsxccdx&smartcrops-aspect-ratios=vqkmzmvchiwlxdaikxqrsbrpvyq&gender-neutral-caption=True&api-version=2024-02-01

"Ynl0ZXM="

Voorbeeldrespons

Statuscode:: 200

{
  "captionResult": {
    "text": "wjtogwbozwgawzxikwsvs",
    "confidence": 0
  },
  "objectsResult": {
    "values": [
      {
        "id": "bcvupjoxcviiz",
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        },
        "tags": [
          {
            "name": "ikiqzvbmyrbuskhpphgjjuzvl",
            "confidence": 0
          }
        ]
      }
    ]
  },
  "readResult": {
    "blocks": [
      {
        "lines": [
          {
            "text": "ufmjctoebx",
            "boundingPolygon": [
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              },
              {
                "x": 0,
                "y": 0
              }
            ],
            "words": [
              {
                "text": "cpcsgoi",
                "boundingPolygon": [
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  },
                  {
                    "x": 0,
                    "y": 0
                  }
                ],
                "confidence": 0
              }
            ]
          }
        ]
      }
    ]
  },
  "denseCaptionsResult": {
    "values": [
      {
        "text": "hgvxqwxwqgtjfippp",
        "confidence": 0,
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        }
      }
    ]
  },
  "modelVersion": "lymqyonwrxckwzrsxjihbceclts",
  "metadata": {
    "width": 28,
    "height": 7
  },
  "tagsResult": {
    "values": [
      {
        "name": "ikiqzvbmyrbuskhpphgjjuzvl",
        "confidence": 0
      }
    ]
  },
  "smartCropsResult": {
    "values": [
      {
        "aspectRatio": 7,
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        }
      }
    ]
  },
  "peopleResult": {
    "values": [
      {
        "boundingBox": {
          "x": 0,
          "y": 0,
          "w": 24,
          "h": 5
        },
        "confidence": 0
      }
    ]
  }
}

ImageAnalysis_Analyze_MinimumSet_Gen

Voorbeeldaanvraag

HTTP

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

"Ynl0ZXM="

Voorbeeldrespons

Statuscode:: 200

{
  "modelVersion": "lymqyonwrxckwzrsxjihbceclts",
  "metadata": {
    "width": 28,
    "height": 7
  }
}

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 die in een afbeelding is gedetecteerd.
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	Foutinformatie.
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.
ObjectsResult	Beschrijft gedetecteerde objecten in een afbeelding.
PeopleResult	Een object waarin wordt beschreven of de afbeelding personen bevat.
ReadResult	De resultaten van een leesbewerking.
SmartCropsResult	Slim bijsnijden resultaat.
TagsResult	Een lijst met tags met betrouwbaarheidsniveau.
VisualFeature	De aangevraagde visuele functies. Er moet ten minste één visuele functie worden opgegeven.

BoundingBox

Object

Een begrenzingsvak voor een gebied in een afbeelding.

Name	Type	Description
h	integer (int32) minimum: 1	Hoogte gemeten vanaf het linkerbovenpunt van het gebied, in pixels.
w	integer (int32) minimum: 1	Breedte gemeten vanaf het linkerbovenpunt van het gebied, in pixels.
x	integer (int32) minimum: 0	Linkscoördinaat van het linkerbovenpunt van het gebied, in pixels.
y	integer (int32) minimum: 0	Bovenste coördinaat van het linkerbovenpunt van het gebied, in pixels.

CaptionResult

Object

Een korte beschrijving van wat de afbeelding weergeeft.

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

ContentTag

Object

Een entiteitsobservatie in de afbeelding, samen met de betrouwbaarheidsscore.

Name	Type	Description
confidence	number (double) minimum: 0 maximum: 1	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 minLength: 1	Naam van de entiteit.

CropRegion

Object

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

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

DenseCaption

Object

Een korte beschrijving van wat de afbeelding weergeeft.

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

DenseCaptionsResult

Object

Een lijst met bijschriften.

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

DetectedObject

Object

Beschrijft een gedetecteerd object in een afbeelding.

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

DetectedPerson

Object

Een persoon die in een afbeelding is gedetecteerd.

Name	Type	Description
boundingBox	BoundingBox	Een begrenzingsvak voor een gebied in een afbeelding.
confidence	number (double) minimum: 0 maximum: 1	Betrouwbaarheidsscore van het waargenomen 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

Object

Een gedetecteerd tekstblok.

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

DetectedTextLine

Object

Een gedetecteerde tekstregel.

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

DetectedTextWord

Object

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 (double) minimum: 0 maximum: 1	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 minLength: 1	Tekstinhoud van het woord.

ErrorResponse

Object

Antwoord geretourneerd wanneer er een fout optreedt.

Name	Type	Description
error	ErrorResponseDetails	Foutinformatie.

ErrorResponseDetails

Object

Foutinformatie.

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

ErrorResponseInnerError

Object

Gedetailleerde fout.

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

ImageAnalysisResult

Object

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 minLength: 1	Modelversie.
objectsResult	ObjectsResult	Beschrijft gedetecteerde objecten in een afbeelding.
peopleResult	PeopleResult	Een object waarin wordt beschreven of de afbeelding personen bevat.
readResult	ReadResult	De resultaten van een leesbewerking.
smartCropsResult	SmartCropsResult	Slim bijsnijden resultaat.
tagsResult	TagsResult	Een lijst met tags met betrouwbaarheidsniveau.

ImageMetadata

Object

De metagegevens van de afbeelding, zoals hoogte en breedte.

Name	Type	Description
height	integer (int32) minimum: 1	De hoogte van de afbeelding in pixels.
width	integer (int32) minimum: 1	De breedte van de afbeelding in pixels.

ImagePoint

Object

Een object dat een punt in de afbeelding vertegenwoordigt.

Name	Type	Description
x	integer (int32) minimum: 0	De x-coördinaat van dit punt.
y	integer (int32) minimum: 0	De y-coördinaat van dit punt.

ObjectsResult

Object

Beschrijft gedetecteerde objecten in een afbeelding.

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

PeopleResult

Object

Een object waarin wordt beschreven of de afbeelding personen bevat.

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

ReadResult

Object

De resultaten van een leesbewerking.

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

SmartCropsResult

Object

Slim bijsnijden resultaat.

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

TagsResult

Object

Een lijst met tags met betrouwbaarheidsniveau.

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

VisualFeature

Inventarisatie

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

Waarde	Description
caption	Een beschrijving of een bijschrift waarin de inhoud van de afbeelding wordt samengevat.
denseCaptions	Gedetailleerde bijschriften bieden uitgebreide beschrijvingen van de inhoud van de afbeelding.
objects	Specifieke objecten die in de afbeelding worden herkend en gelabeld.
people	Detectie en analyse van personen in de afbeelding.
read	Tekstuele inhoud die is geëxtraheerd uit de afbeelding, zoals tekens of labels.
smartCrops	Automatisch gegenereerde bijgesneden versies van de afbeelding die gericht zijn op belangrijke inhoud.
tags	Visuele tags die objecten vertegenwoordigen die zijn gedetecteerd in de afbeelding.

Delen via

Analyze - Image Stream

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

ObjectsResult

PeopleResult

ReadResult

SmartCropsResult

TagsResult

VisualFeature