Detección de objetos - OpenSearch - Centro de documentación de Alibaba Cloud

Detecta e identifica uno o más objetos en una imagen para aplicaciones de visión por computadora, como vigilancia inteligente, conducción autónoma y búsqueda de imágenes.

Nombre del servicio	ID del servicio	Descripción	Límite de QPS de la API
servicio de detección de objetos	ops-object-detect-001	Modelo de detección de varios objetos desarrollado por el equipo de Alibaba Cloud OpenSearch-AI. Detecta varios objetos independientes en una imagen y devuelve un cuadro delimitador y una puntuación de confianza para cada uno. Extrae objetos de escenas complejas como entrada para tareas posteriores, lo que ayuda a eliminar la interferencia de fondos u otros objetos al usarse con modelos de embedding y reclasificación.	20 Nota Para solicitar un límite de QPS de la API mayor, envíe un ticket al soporte técnico.

servicio de detección facial	ops-object-detect-face-001	Detecta y localiza automáticamente uno o más rostros en una imagen. Es ideal para aplicaciones como vigilancia inteligente y búsqueda de imágenes.

Requisitos previos

Obtenga las credenciales de autenticación

La plataforma abierta AI Search requiere una clave de API para la autenticación. Para obtener instrucciones, consulte Get an API key.
Obtenga el endpoint del servicio

Puede invocar el servicio mediante la red pública o una VPC. Para más detalles, consulte Get the service endpoint.

Detalles de la solicitud

Notas generales

El cuerpo de la solicitud no debe superar los 8 MB.

Método HTTP

POST

URL

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

Parámetros:

host: El endpoint del servicio. Para más detalles, consulte Get a service endpoint. El dominio de API pública proporciona acceso a la red pública, mientras que el dominio de API interna permite el acceso desde la misma región (incluso desde una VPC). Ambos endpoints admiten HTTPS.
workspace_name: El nombre de su espacio de trabajo, por ejemplo, default.
service_id: El ID del servicio integrado, por ejemplo, ops-object-detect-001.

Parámetros de la solicitud

Parámetros de encabezado

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Content-Type	String	Sí	El tipo de contenido de la solicitud. Debe ser `application/json`.	application/json
Authorization	String	Sí	Su clave de API para la autenticación. Debe incluir el prefijo `Bearer` .	Bearer OS-d1**2a

Parámetros del cuerpo

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

service_id

String

Sí

El ID del servicio. El valor debe comenzar con ops-.

ops-object-detect-001

image

Object

Sí

La imagen para procesar. Proporcione la imagen mediante uno de los siguientes parámetros:

url: Una URL de acceso público de la imagen.
content: El contenido del archivo de imagen, codificado como una cadena base64.

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

Parámetros de respuesta

Parámetro	Tipo	Descripción	Ejemplo
request_id	String	Identificador único de la solicitud generado por el sistema.	A5B25952-4406-45BF-99EC-E8020246****
latency	Float/Integer	Latencia de la solicitud, en milisegundos (ms).	10
usage.image	Integer	Número de imágenes procesadas.	1
result.objects	List<ImageObject>	Lista de los objetos detectados.	`[ { "confidence": 0.8, "location": { "X" : 228, "Y" : 240, "height" : 430, "width" : 678 } } ]`

ImageObject

Parámetro	Tipo	Descripción	Ejemplo
confidence	Float	Puntuación de confianza de la detección, con un rango de 0.0 a 1.0. Los valores más altos indican mayor confianza.	0.4017
location	Object	Coordenadas del cuadro delimitador del objeto detectado.
location.width	Integer	Ancho del cuadro delimitador, en píxeles.	176
location.height	Integer	Altura del cuadro delimitador, en píxeles.	188
location.Y	Integer	Coordenada Y de la esquina superior izquierda del cuadro delimitador.	560
location.X	Integer	Coordenada X de la esquina superior izquierda del cuadro delimitador.	37

Solicitud de ejemplo (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"
    }
}'

Respuesta de ejemplo

Respuesta exitosa

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

Códigos de estado

Para más detalles, consulte los Status Codes de la plataforma abierta AI Search.