Describe Image - Describe Image

Layanan:

Azure AI Services

Versi API:

3.2

Operasi ini menghasilkan deskripsi gambar dalam bahasa yang dapat dibaca manusia dengan kalimat lengkap. Deskripsi didasarkan pada kumpulan tag konten, yang juga dikembalikan oleh operasi. Lebih dari satu deskripsi dapat dibuat untuk setiap gambar. Deskripsi diurutkan berdasarkan skor kepercayaan mereka. Deskripsi dapat mencakup hasil dari model domain selebriti dan landmark, jika berlaku. Dua metode input didukung -- (1) Mengunggah gambar atau (2) yang menentukan URL gambar. Respons yang berhasil akan dikembalikan di JSON. Jika permintaan gagal, respons akan berisi kode kesalahan dan pesan untuk membantu memahami apa yang salah.

POST {Endpoint}/vision/v3.2/describe

Dengan parameter opsional:

POST {Endpoint}/vision/v3.2/describe?maxCandidates={maxCandidates}&language={language}&descriptionExclude={descriptionExclude}&model-version={model-version}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
Endpoint	path	True	string	Titik akhir Cognitive Services yang didukung.
descriptionExclude	query		DescriptionExclude[]	Nonaktifkan model domain tertentu saat membuat deskripsi.
language	query		string	Bahasa yang diinginkan untuk pembuatan output. Jika parameter ini tidak ditentukan, nilai defaultnya adalah "en". Lihat https://aka.ms/cv-languages untuk daftar bahasa yang didukung.
maxCandidates	query		integer (int32)	Jumlah maksimum deskripsi kandidat yang akan dikembalikan. Defaultnya adalah 1.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Parameter opsional untuk menentukan versi model AI. Nilai yang diterima adalah: "latest", "2021-04-01", "2021-05-01". Default ke "terbaru".

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
Ocp-Apim-Subscription-Key	True	string

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
url	True	string	URL gambar yang dapat dijangkau secara publik.

Respons

Nama	Jenis	Deskripsi
200 OK	ImageDescription	Objek deskripsi gambar.
Other Status Codes	ComputerVisionErrorResponse	Respons kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Jenis: apiKey
Dalam: header

Contoh

Successful DescribeImage request

Permintaan sampel

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/describe?maxCandidates=1


{
  "url": "{url}"
}

Respon sampel

Kode status:

200

{
  "description": {
    "tags": [
      "person",
      "man",
      "outdoor",
      "window",
      "glasses"
    ],
    "captions": [
      {
        "text": "Satya Nadella sitting on a bench",
        "confidence": 0.48293603002174407
      }
    ]
  },
  "requestId": "ed2de1c6-fb55-4686-b0da-4da6e05d283f",
  "metadata": {
    "width": 1500,
    "height": 1000,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

Definisi

Nama	Deskripsi
ComputerVisionError	Kesalahan permintaan API.
ComputerVisionErrorCodes	Kode kesalahan.
ComputerVisionErrorResponse	Respons kesalahan API.
ComputerVisionInnerError	Detail tentang kesalahan permintaan API.
ComputerVisionInnerErrorCodeValue	Kode kesalahan.
DescriptionExclude	Nonaktifkan model domain tertentu saat membuat deskripsi.
ImageCaption	Keterangan gambar, yaitu deskripsi singkat tentang apa yang digambarkan gambar.
ImageDescription	Kumpulan tag konten, bersama dengan daftar keterangan yang diurutkan berdasarkan tingkat keyakinan, dan metadata gambar.
ImageMetadata	Metadata gambar.
ImageUrl

ComputerVisionError

Objek

Kesalahan permintaan API.

Nama	Jenis	Deskripsi
code	ComputerVisionErrorCodes	Kode kesalahan.
innererror	ComputerVisionInnerError	Kesalahan dalam berisi informasi yang lebih spesifik.
message	string	Pesan yang menjelaskan kesalahan yang dilaporkan oleh layanan.

ComputerVisionErrorCodes

Enumeration

Kode kesalahan.

Nilai	Deskripsi
InternalServerError
InvalidArgument
InvalidRequest
ServiceUnavailable

ComputerVisionErrorResponse

Objek

Respons kesalahan API.

Nama	Jenis	Deskripsi
error	ComputerVisionError	Isi kesalahan.

ComputerVisionInnerError

Objek

Detail tentang kesalahan permintaan API.

Nama	Jenis	Deskripsi
code	ComputerVisionInnerErrorCodeValue	Kode kesalahan.
message	string	Pesan kesalahan.

ComputerVisionInnerErrorCodeValue

Enumeration

Kode kesalahan.

Nilai	Deskripsi
BadArgument
CancelledRequest
DetectFaceError
FailedToProcess
InternalServerError
InvalidDetails
InvalidImageFormat
InvalidImageSize
InvalidImageUrl
InvalidModel
InvalidThumbnailSize
NotSupportedFeature
NotSupportedImage
NotSupportedLanguage
NotSupportedVisualFeature
StorageException
Timeout
Unspecified
UnsupportedMediaType

DescriptionExclude

Enumeration

Nonaktifkan model domain tertentu saat membuat deskripsi.

Nilai	Deskripsi
Celebrities
Landmarks

ImageCaption

Objek

Keterangan gambar, yaitu deskripsi singkat tentang apa yang digambarkan gambar.

Nama	Jenis	Deskripsi
confidence	number (double)	Tingkat keyakinan yang dimiliki layanan dalam keterangan.
text	string	Teks keterangan.

ImageDescription

Objek

Kumpulan tag konten, bersama dengan daftar keterangan yang diurutkan berdasarkan tingkat keyakinan, dan metadata gambar.

Nama	Jenis	Deskripsi
description.captions	ImageCaption[]	Daftar keterangan, diurutkan menurut tingkat keyakinan.
description.tags	string[]	Kumpulan tag gambar.
metadata	ImageMetadata	Metadata gambar.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Versi model AI.
requestId	string	Id permintaan REST API.

ImageMetadata

Objek

Metadata gambar.

Nama	Jenis	Deskripsi
format	string	Format gambar.
height	integer (int32)	Tinggi gambar, dalam piksel.
width	integer (int32)	Lebar gambar, dalam piksel.

ImageUrl

Objek

Nama	Jenis	Deskripsi
url	string	URL gambar yang dapat dijangkau secara publik.