Deteksi objek - OpenSearch - Alibaba Cloud Documentation Center

Layanan ini secara otomatis mendeteksi dan mengidentifikasi satu atau beberapa objek dalam gambar, ideal untuk aplikasi visi komputer umum seperti pengawasan cerdas, kendaraan otonom, dan image search.

Nama layanan	ID layanan	Deskripsi	API QPS Limit
object detection service	ops-object-detect-001	Model deteksi multi-objek ini, yang dikembangkan oleh tim Alibaba Cloud OpenSearch-AI, mendeteksi beberapa objek independen dalam sebuah gambar dan mengembalikan kotak pembatas serta tingkat kepercayaan untuk masing-masing objek. Anda dapat menggunakannya untuk mengekstraksi objek dari adegan kompleks sebagai input untuk tugas downstream, guna membantu menghilangkan gangguan dari latar belakang gambar atau objek lain dengan model penyematan dan penyusunan ulang.	20 Catatan

face detection service	ops-object-detect-face-001	Secara otomatis mendeteksi dan menentukan lokasi satu atau beberapa wajah dalam sebuah gambar. Ideal untuk aplikasi seperti pengawasan cerdas dan image search.

Prasyarat

Detail permintaan

Catatan umum

Ukuran badan permintaan tidak boleh melebihi 8 MB.

Metode HTTP

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/image-object-detection/{service_id}

Parameter:

host: Titik akhir layanan. Anda dapat memanggil layanan API melalui jaringan publik atau dari VPC. Untuk detailnya, lihat Dapatkan titik akhir layanan. Domain API publik menyediakan akses jaringan publik, sedangkan domain API internal menyediakan akses dari dalam wilayah yang sama (termasuk dari VPC). Kedua titik akhir mendukung protokol HTTPS.
workspace_name: Nama ruang kerja Anda, misalnya default.
service_id: ID layanan bawaan, misalnya ops-object-detect-001.

Parameter permintaan

Parameter header

Parameter	Jenis	Wajib	Deskripsi	Contoh
Content-Type	String	Ya	Tipe konten permintaan. Nilainya harus `application/json`.	application/json
Authorization	String	Ya	Kunci API Anda untuk otentikasi. Nilainya harus diawali dengan `Bearer` .	Bearer OS-d1**2a

Parameter body

Parameter

Jenis

Wajib

Deskripsi

Contoh

service_id

String

ID layanan. Nilainya harus diawali dengan ops-.

ops-object-detect-001

image

Object

Gambar yang akan diproses. Anda harus menyediakan gambar menggunakan salah satu parameter berikut:

url: URL gambar yang dapat diakses publik.
content: Konten file gambar, dikodekan sebagai string base64.

{
 "url":"http://example.com/image.jpg"
}

Parameter respons

Parameter	Jenis	Deskripsi	Contoh
request_id	String	Identifikasi unik yang dihasilkan sistem untuk permintaan tersebut.	A5B25952-4406-45BF-99EC-E8020246****
latency	Float/Integer	Latensi permintaan, dalam milidetik (ms).	10
usage.image	Integer	Jumlah gambar yang diproses.	1
result.objects	List<ImageObject>	Daftar objek yang terdeteksi.	`[ { "confidence": 0.8, "location": { "X" : 228, "Y" : 240, "height" : 430, "width" : 678 } } ]`

ImageObject

Parameter	Tipe	Deskripsi	Contoh
confidence	Float	Tingkat kepercayaan deteksi, berkisar antara 0,0 hingga 1,0. Nilai yang lebih tinggi menunjukkan kepercayaan yang lebih besar.	0,4017
location	Object	Objek yang berisi koordinat kotak pembatas.
location.width	Integer	Lebar kotak pembatas, dalam piksel.	176
location.height	Integer	Tinggi kotak pembatas, dalam piksel.	188
location.Y	Integer	Koordinat y dari pojok kiri atas kotak pembatas.	560
location.X	Integer	Koordinat x dari pojok kiri atas kotak pembatas.	37

Contoh permintaan (cURL)

curl --location 'http://****-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/image-object-detection/ops-object-detect-001/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "image":
    {
      "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250408/syuvxh/%E7%89%A9%E4%BD%93%E5%AE%9A%E4%BD%8D.png"
    }
}'

Contoh respons

Respons sukses

{
  "request_id": "138611ad4a03f620a1cdb2904768d286",
  "latency": 216,
  "usage": {
    "image": 1
  },
  "result": {
    "objects": [
      {
        "confidence": 0.4017,
        "location": {
          "width": 176,
          "height": 188,
          "X": 37,
          "Y": 560
        }
      },
      {
        "confidence": 0.3805,
        "location": {
          "width": 191,
          "height": 200,
          "X": 133,
          "Y": 752
        }
      },
      {
        "confidence": 0.3290,
        "location": {
          "width": 175,
          "height": 183,
          "X": 359,
          "Y": 663
        }
      },
      {
        "confidence": 0.2955,
        "location": {
          "width": 984,
          "height": 897,
          "X": 16,
          "Y": 8
        }
      },
      {
        "confidence": 0.2613,
        "location": {
          "width": 172,
          "height": 174,
          "X": 516,
          "Y": 559
        }
      },
      {
        "confidence": 0.2573,
        "location": {
          "width": 360,
          "height": 228,
          "X": 665,
          "Y": 704
        }
      },
      {
        "confidence": 0.2419,
        "location": {
          "width": 139,
          "height": 170,
          "X": 248,
          "Y": 388
        }
      },
      {
        "confidence": 0.1644,
        "location": {
          "width": 173,
          "height": 205,
          "X": 815,
          "Y": 507
        }
      },
      {
        "confidence": 0.1134,
        "location": {
          "width": 140,
          "height": 122,
          "X": 440,
          "Y": 446
        }
      }
    ]
  }
}

Kode status

Untuk detailnya, lihat Kode Status pada AI Search Open Platform.