Developers

Recursos Cross

Explora los recursos principales de nuestras APIs

Puedes usar esta documentación para las siguientes unidades de negocio:

Última actualización 28/05/2025

Diagnóstico de imágenes

Para mejorar la experiencia del seller y reducir moderaciones, es posible diagnosticar imágenes de forma síncrona antes de asociarlas a un ítem, utilizando la API de diagnóstico de imágenes.

Esta funcionalidad permite:

Obtener solo los problemas actuales de una imagen.
Diagnosticar antes de asociar la imagen a la publicación.
Mostrar mensajes claros (wordings) para que el seller pueda corregir errores fácilmente.

Nota:

Actualmente esta API solo diagnostica los siguientes criterios:

white_background.
minimum_size.
minimum_size.
watermark.

Ejemplo:

curl --location 'https://api.mercadolibre.com/moderations/pictures/diagnostic' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $ACCESS_TOKEN' \
--data '{
  "id": "f0b6198b-a4ef-4291-82a5-41956e0af96e",
  "picture_url": "https://miurl.com/mi_imagen.jpg",
  "context": {
    "category_id": "MLA1346",
    "title": "This a item title"
  }
}'

Campos del body:

Atributo	Descripción	Obligatorio	Observación
id	Identificador del diagnóstico	No	Si no se envía se genera automáticamente.
picture_url	URL de la imagen, base64 o picture_id de CDN de Meli	Sí	https://{{picture}}
context	Información adicional contextual	Sí
context.category_id	ID de la categoría del ítem	Sí	Se eligen los criterios a evaluar dependiendo de la categoría donde se desea usar la foto. Para casos donde la categoría enviada no exista, solo se evaluará el minimum_size
context.title	Título de la publicación	No	Recomendado para mayor contexto de la publicación
context.picture_type	Tipo de imagen (thumbnail \| variation_thumbnail \| other)	No	Indica dónde se va a usar la foto dentro del ítem, si se entrega, filtra el resultado, si no, se evalúan todas.

Respuesta:

{
  "id": "f0b6198b-a4ef-4291-82a5-41956e0af96e",
  "diagnostics": [
    {
      "picture_type": "thumbnail",
      "action": "diagnostic",
      "detections": [
        {
          "name": "text_logo",
          "wordings": [
            {
              "kind": "REMEDY_SHORT",
              "value": "Elimina tus fotos que contienen logos y/o textos."
            }
          ]
        },
        {
          "name": "white_background",
          "wordings": [
            {
              "kind": "REMEDY_SHORT",
              "value": "El fondo de tu foto debe ser blanco digitalizado. Podés corregirla con nuestro editor."
            }
          ]
        }
      ]
    },
    {
      "picture_type": "variation thumbnail",
      "action": "diagnostic",
      "detections": [
        {
          "name": "text_logo",
          "wordings": [
            {
              "kind": "REMEDY_SHORT",
              "value": "Elimina tus fotos que contienen logos y/o textos."
            }
          ]
        },
        {
          "name": "white_background",
          "wordings": [
            {
              "kind": "REMEDY_SHORT",
              "value": "El fondo de tu foto debe ser blanco digitalizado. Podés corregirla con nuestro editor."
            }
          ]
        }
      ]
    },
    {
      "picture_type": "other",
      "action": "empty",
      "detections": []
    }
  ]
}

Campos de respuesta:

id: identificador del diagnóstico
diagnostics: Listado de detecciones por tipo de foto (thumbnail | variation thumbnail | other)
- picture_type: Tipo de foto para la cual aplica la detección (thumbnail | variation thumbnail | other)
- detections: Listado de todas las detecciones que fueron encontradas para la foto (si la acción es empty se retorna vacío este campo.)
  - name: Nombre de la detección
  - wordings: Texto amigable para mostrar al usuario final.
    - kind: tipo de wordings (siempre REMEDY_SHORT)
    - value: Valor del wording al usuario final.

Siguiente: Moderaciones de Imágenes