Share via


Az Image Analysis 3.2 API meghívása

Ez a cikk bemutatja, hogyan hívhatja meg az Image Analysis 3.2 API-t a kép vizuális funkcióival kapcsolatos információk visszaadásához. Azt is bemutatja, hogyan elemezheti a visszaadott adatokat az ügyféloldali SDK-k vagy a REST API használatával.

Ez az útmutató feltételezi, hogy már létrehozott egy Vision-erőforrást , és beszerzett egy kulcsot és egy végpont URL-címet. Ha ügyféloldali SDK-t használ, egy ügyfélobjektumot is hitelesítenie kell. Ha még nem tette meg ezeket a lépéseket, kövesse a rövid útmutatót az első lépésekhez.

Adatok küldése a szolgáltatásba

Az útmutatóban szereplő kód az URL-cím alapján hivatkozott távoli képeket használja. Érdemes lehet önállóan különböző képeket kipróbálnia a képelemzési funkciók teljes kapacitásának megtekintéséhez.

Távoli rendszerkép elemzésekor a rendszerkép URL-címét úgy adhatja meg, hogy a kérelem törzsét a következőképpen formázzuk: {"url":"http://example.com/images/test.jpg"}.

A helyi rendszerkép elemzéséhez a bináris képadatokat a HTTP-kérelem törzsébe kell helyeznie.

Az adatok feldolgozásának meghatározása

Vizuális funkciók kiválasztása

Az Analyze API hozzáférést biztosít a szolgáltatás képelemzési funkcióihoz. Válassza ki, hogy a saját használati esete alapján mely műveleteket végezze el. Az egyes funkciók leírását az áttekintésben tekintheti meg. Az alábbi szakaszokban található példák az összes elérhető vizualizációs funkciót hozzáadják, de a gyakorlati használathoz valószínűleg csak egy vagy kettő szükséges.

Az Analyze API URL-lekérdezési paramétereinek beállításával megadhatja, hogy mely funkciókat szeretné használni. Egy paraméter több értékkel is rendelkezhet, vesszővel elválasztva. Minden megadott funkcióhoz több számítási idő szükséges, ezért csak a szükséges adatok megadása szükséges.

URL-paraméter Érték Leírás
features Read Beolvassa a képen látható szöveget, és strukturált JSON-adatként adja ki.
features Description a képtartalmat egy teljes mondattal, támogatott nyelveken írja le.
features SmartCrops megkeresi azokat a téglalapkoordinátákat, amelyek a kívánt méretarányra vágnák a képet, miközben megőrzik az érdeklődési területet.
features Objects különböző objektumokat észlel egy képen belül, beleértve a hozzávetőleges helyet is. Az Objects argumentum csak angol nyelven érhető el.
features Tags a kép címkéje a kép tartalmához kapcsolódó szavak részletes listájával.

A feltöltött URL-címek a következőképpen nézhetnek ki:

<endpoint>/vision/v3.2/analyze?visualFeatures=Tags

Nyelvek megadása

Megadhatja a visszaadott adatok nyelvét is.

Az alábbi URL-lekérdezési paraméter határozza meg a nyelvet. Az alapértelmezett érték en.

URL-paraméter Érték Leírás
language en Angol
language es Spanyol
language ja Japán
language pt Portugál
language zh Egyszerűsített kínai

A feltöltött URL-címek a következőképpen nézhetnek ki:

<endpoint>/vision/v3.2/analyze?visualFeatures=Tags&language=en

Eredmények lekérése a szolgáltatásból

Ez a szakasz bemutatja, hogyan elemezheti az API-hívás eredményeit. Magában foglalja magát az API-hívást.

Feljegyzés

Hatókörön belüli API-hívások

A Képelemzés egyes funkciói közvetlenül és az Analyze API-híváson keresztül is meghívhatók. Például csak a képcímkék hatókörön belüli elemzését végezheti el úgy, hogy kérést <endpoint>/vision/v3.2/tag küld (vagy az SDK megfelelő metódusára). További, külön meghívható funkciókra vonatkozó referenciadokumentáció.

A szolgáltatás HTTP-választ ad 200 vissza, a törzs pedig JSON-sztring formájában tartalmazza a visszaadott adatokat. Az alábbi szöveg egy JSON-válasz példája.

{
    "metadata":
    {
        "width": 300,
        "height": 200
    },
    "tagsResult":
    {
        "values":
        [
            {
                "name": "grass",
                "confidence": 0.9960499405860901
            },
            {
                "name": "outdoor",
                "confidence": 0.9956876635551453
            },
            {
                "name": "building",
                "confidence": 0.9893627166748047
            },
            {
                "name": "property",
                "confidence": 0.9853052496910095
            },
            {
                "name": "plant",
                "confidence": 0.9791355729103088
            }
        ]
    }
}

Hibakódok

Tekintse meg az alábbi listát a lehetséges hibákról és azok okairól:

  • 400
    • InvalidImageUrl - A kép URL-címe rosszul formázott vagy nem érhető el.
    • InvalidImageFormat – A bemeneti adatok nem érvényesek.
    • InvalidImageSize - A bemeneti kép túl nagy.
    • NotSupportedVisualFeature – A megadott szolgáltatástípus érvénytelen.
    • NotSupportedImage - Nem támogatott kép, például gyermekpornográfia.
    • InvalidDetails - Nem támogatott detail paraméterérték.
    • NotSupportedLanguage – A kért művelet nem támogatott a megadott nyelven.
    • BadArgument – További részleteket a hibaüzenet tartalmaz.
  • 415 – Nem támogatott médiatípusú hiba. A Tartalomtípus nem az engedélyezett típusok között van:
    • Kép URL-címe esetén a tartalomtípusnak application/json
    • Bináris képadatok esetén a tartalomtípusnak application/octet-stream vagy multipart/form-data
  • 500
    • FailedToProcess
    • Timeout - A képfeldolgozás időtúllépést eredményez.
    • InternalServerError

Tipp.

Az Azure AI Vision használata során átmeneti hibákat tapasztalhat, amelyeket a szolgáltatás által kikényszerített sebességkorlátozások vagy más átmeneti problémák, például a hálózati kimaradások okoznak. Az ilyen típusú hibák kezelésével kapcsolatos információkért tekintse meg az Újrapróbálkozási mintát a Felhőtervezési minták útmutatójában és a kapcsolódó megszakító mintában.

Következő lépések