Detect Objects In Stream - Detect Objects In Stream

Layanan:

Azure AI Services

Versi API:

3.2

Melakukan deteksi objek pada gambar yang ditentukan. 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/detect

Dengan parameter opsional:

POST {Endpoint}/vision/v3.2/detect?overload=stream&model-version={model-version}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
Endpoint	path	True	string	Titik akhir Cognitive Services yang didukung.
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

Media Types: "application/octet-stream", "multipart/form-data"

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

Isi Permintaan

Media Types: "application/octet-stream", "multipart/form-data"

Nama	Jenis	Deskripsi
Image	object (file)	Aliran gambar.

Respons

Nama	Jenis	Deskripsi
200 OK	DetectResult	Respons mencakup objek yang terdeteksi dalam format JSON.
Other Status Codes	ComputerVisionErrorResponse	Respons kesalahan.

Keamanan

Ocp-Apim-Subscription-Key

Jenis: apiKey
Dalam: header

Contoh

Successful DetectObjects request

Permintaan sampel

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/detect?overload=stream


"{binary}"

Respon sampel

Kode status:

200

{
  "objects": [
    {
      "rectangle": {
        "x": 0,
        "y": 0,
        "w": 50,
        "h": 50
      },
      "object": "tree",
      "confidence": 0.9,
      "parent": {
        "object": "plant",
        "confidence": 0.95
      }
    }
  ],
  "requestId": "1ad0e45e-b7b4-4be3-8042-53be96103337",
  "metadata": {
    "width": 100,
    "height": 100,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

Definisi

Nama	Deskripsi
BoundingRect	Kotak pembatas untuk area di dalam gambar.
ComputerVisionError	Kesalahan permintaan API.
ComputerVisionErrorCodes	Kode kesalahan.
ComputerVisionErrorResponse	Respons kesalahan API.
ComputerVisionInnerError	Detail tentang kesalahan permintaan API.
ComputerVisionInnerErrorCodeValue	Kode kesalahan.
DetectedObject	Objek yang terdeteksi dalam gambar.
DetectResult	Hasil panggilan DetectImage.
ImageMetadata	Metadata gambar.
ObjectHierarchy	Objek yang terdeteksi di dalam gambar.

BoundingRect

Objek

Kotak pembatas untuk area di dalam gambar.

Nama	Jenis	Deskripsi
h	integer (int32)	Tinggi diukur dari titik kiri atas area, dalam piksel.
w	integer (int32)	Lebar diukur dari titik kiri atas area, dalam piksel.
x	integer (int32)	Koordinat X dari titik kiri atas area, dalam piksel.
y	integer (int32)	Koordinat Y dari titik kiri atas area, dalam piksel.

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
InvalidRequest
InvalidArgument
InternalServerError
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
InvalidImageFormat
UnsupportedMediaType
InvalidImageUrl
NotSupportedFeature
NotSupportedImage
Timeout
InternalServerError
InvalidImageSize
BadArgument
DetectFaceError
NotSupportedLanguage
InvalidThumbnailSize
InvalidDetails
InvalidModel
CancelledRequest
NotSupportedVisualFeature
FailedToProcess
Unspecified
StorageException

DetectedObject

Objek

Objek yang terdeteksi dalam gambar.

Nama	Jenis	Deskripsi
confidence	number (double)	Skor keyakinan telah mengamati objek dalam gambar, sebagai nilai mulai dari 0 hingga 1.
object	string	Label untuk objek.
parent	ObjectHierarchy	Objek induk, dari perspektif taksonomi. Objek induk adalah bentuk objek ini yang lebih umum. Misalnya, 'bulldog' akan memiliki induk 'anjing'.
rectangle	BoundingRect	Perkiraan lokasi objek yang terdeteksi.

DetectResult

Objek

Hasil panggilan DetectImage.

Nama	Jenis	Deskripsi
metadata	ImageMetadata	Metadata gambar.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Versi model AI.
objects	DetectedObject[]	Array objek yang terdeteksi.
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.

ObjectHierarchy

Objek

Objek yang terdeteksi di dalam gambar.

Nama	Jenis	Deskripsi
confidence	number (double)	Skor keyakinan telah mengamati objek dalam gambar, sebagai nilai mulai dari 0 hingga 1.
object	string	Label untuk objek.
parent	ObjectHierarchy	Objek induk, dari perspektif taksonomi. Objek induk adalah bentuk objek ini yang lebih umum. Misalnya, 'bulldog' akan memiliki induk 'anjing'.