Volání rozhraní API pro analýzu obrázků 3.2

Tento článek ukazuje, jak volat rozhraní API pro analýzu obrázků 3.2, které vrací informace o vizuálních funkcích obrázku. Také ukazuje, jak analyzovat vrácené informace pomocí klientských sad SDK nebo rozhraní REST API.

V této příručce se předpokládá, že jste už vytvořili prostředek Vision a získali adresu URL klíče a koncového bodu. Pokud používáte klientskou sadu SDK, budete také muset ověřit objekt klienta. Pokud jste tyto kroky ještě neudělali, začněte podle tohoto rychlého startu.

Odeslání dat do služby

Kód v této příručce používá vzdálené obrázky, na které odkazuje adresa URL. Možná si budete chtít vyzkoušet různé obrázky, abyste viděli všechny funkce analýzy obrázků.

Při analýze vzdáleného obrázku zadáte adresu URL obrázku tak, že naformátujete text požadavku takto: {"url":"http://example.com/images/test.jpg"}.

Pokud chcete analyzovat místní obrázek, vložte data binárního obrázku do textu požadavku HTTP.

Určení způsobu zpracování dat

Výběr vizuálních funkcí

Rozhraní API pro analýzu obrázků poskytuje přístup ke všem funkcím analýzy obrázků služby. Vyberte, které operace se mají provést na základě vašeho vlastního případu použití. V přehledu najdete popis jednotlivých funkcí. Příklady v následujících částech přidávají všechny dostupné vizuální funkce, ale pro praktické použití budete pravděpodobně potřebovat jenom jednu nebo dvě.

Můžete určit, které funkce chcete použít, nastavením parametrů dotazu adresy URL rozhraní API pro analýzu. Parametr může mít více hodnot oddělených čárkami. Každá zadaná funkce bude vyžadovat více výpočetních časů, takže určete jenom to, co potřebujete.

Parametr adresy URL Hodnota Popis
features Read přečte viditelný text na obrázku a vypíše ho jako strukturovaná data JSON.
features Description popisuje obsah obrázku s úplnou větou v podporovaných jazycích.
features SmartCrops najde souřadnice obdélníku, které by ořízly obrázek na požadovaný poměr stran při zachování oblasti zájmu.
features Objects rozpozná různé objekty v rámci obrázku, včetně přibližného umístění. Argument Objects je k dispozici pouze v angličtině.
features Tags označí obrázek podrobným seznamem slov souvisejících s obsahem obrázku.

Vyplněná adresa URL může vypadat takto:

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

Určení jazyků

Můžete také zadat jazyk vrácených dat.

Následující parametr dotazu adresy URL určuje jazyk. Výchozí hodnota je en.

Parametr adresy URL Hodnota Popis
language en Angličtina
language es Španělština
language ja japonština
language pt Portugalština
language zh Zjednodušená čínština

Vyplněná adresa URL může vypadat takto:

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

Získání výsledků ze služby

V této části se dozvíte, jak analyzovat výsledky volání rozhraní API. Zahrnuje samotné volání rozhraní API.

Poznámka:

Volání rozhraní API s vymezeným oborem

Některé funkce analýzy obrázků je možné volat přímo i prostřednictvím volání rozhraní API Pro analýzu. Můžete například provést vymezenou analýzu pouze značek obrázků tak, že provedete požadavek <endpoint>/vision/v3.2/tag na (nebo na odpovídající metodu v sadě SDK). Další funkce, které je možné volat samostatně, najdete v referenční dokumentaci .

Služba vrátí 200 odpověď HTTP a tělo obsahuje vrácená data ve formě řetězce JSON. Následující text je příkladem odpovědi JSON.

{
    "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
            }
        ]
    }
}

Kódy chyb

Prohlédněte si následující seznam možných chyb a jejich příčin:

  • 400
    • InvalidImageUrl - Adresa URL obrázku je špatně naformátovaná nebo není přístupná.
    • InvalidImageFormat – Vstupní data nejsou platným obrázkem.
    • InvalidImageSize – Vstupní obrázek je příliš velký.
    • NotSupportedVisualFeature – Zadaný typ funkce není platný.
    • NotSupportedImage - Nepodporovaný obrázek, například dětská pornografie.
    • InvalidDetails – Nepodporovaná hodnota parametru detail .
    • NotSupportedLanguage – Požadovaná operace není v zadaném jazyce podporovaná.
    • BadArgument - Další podrobnosti jsou uvedeny v chybové zprávě.
  • 415 – Chyba nepodporovaného typu média Typ obsahu není v povolených typech:
    • Adresa URL obrázku by měla být typu obsahu. application/json
    • Pro data binárního obrázku by měl být application/octet-stream typ obsahu nebo multipart/form-data
  • 500
    • FailedToProcess
    • Timeout - Vypršel časový limit zpracování obrazu.
    • InternalServerError

Tip

Při práci s Azure AI Vision můžete narazit na přechodná selhání způsobená omezeními rychlosti vynucenými službou nebo jinými přechodnými problémy, jako jsou výpadky sítě. Informace o zpracování těchto typů selhání najdete v části Vzory opakování v průvodci vzory návrhu cloudu a související model jističe.

Další kroky