Guía ilustrada de integración de la API de MeowID

Necesitas una cuenta de MeowID y dos fotos distintas del mismo gato: una para registrarlo y otra para probar. Empieza con una imagen nítida, bien iluminada y con un solo gato.

Flujo: crear proyecto → crear perfil → registrar foto de referencia → esperar a que termine → probar reconocimiento → crear API Key → llamar a la API.

Usa el mismo proyecto para el registro y el reconocimiento. La API está en https://platform.meowid.net.

Abre la consola de MeowID. Inicia sesión o crea una cuenta y después accede.

En la navegación izquierda, pulsa el signo más junto a Proyectos. Si está contraída, ábrela primero con el botón de menú.

Escribe un nombre, por ejemplo «Demo de reconocimiento de gatos»; la descripción es opcional.

Abre el proyecto y copia su ID. Ese valor sustituye a YOUR_PROJECT_ID en la URL. Los perfiles, imágenes y vectores quedan separados por proyecto.

Pulsa «Añadir identidad», introduce un nombre como Mimi y deja la identidad activa para que participe en las búsquedas.

Para guardar personalidad, notas u otros atributos, usa el campo API metadata que se muestra más adelante.

En Gestión de identidades, abre la biblioteca de fotos del gato y selecciona «Añadir imagen de registro».

Selecciona o arrastra una imagen JPEG, PNG o WebP. Comprueba que pertenece al gato antes de subirla. Empieza con una foto clara de un solo gato y añade otros ángulos del mismo gato cuando termine el primer registro.

No registres fotos de gatos distintos en la misma identidad.

La aceptación de la carga no significa que el procesamiento haya terminado. En la cola de tareas del proyecto, busca la tarea de registro y espera a status=completed.

queued y running indican que sigue procesándose. Si aparece waiting_user, selecciona el gato en la consola. Si aparece failed, revisa el error y vuelve a intentarlo tras corregirlo.

Prueba el reconocimiento solo después de completar el registro.

Abre «Gestión de identidades → Prueba de reconocimiento» y sube otra foto del mismo gato. Para el ejemplo, configura el número de resultados en 3 y el umbral de rechazo en 0.35.

top_k=3 devuelve como máximo tres candidatos. 0.35 es solo un ejemplo; ajústalo con tus propias fotos. Prueba imágenes con distintos ángulos, iluminación y fondos.

La captura siguiente es un resultado histórico. 56.61% muestra similitud, no una probabilidad de acierto. La tarea usó la ruta body porque no detectó una cara; también puede comparar características del cuerpo.

Abre «API Keys» y confirma que está seleccionado el proyecto correcto. Crea una clave con un nombre reconocible, por ejemplo meowid-demo-server.

Elige «Personalizado» y deja solo recognition:write para este ejemplo. Comprueba que los demás permisos estén desmarcados.

Configura caducidad y lista de IP permitidas si hace falta. La clave completa solo se muestra una vez: guárdala en el entorno del servidor o en un gestor de secretos. No la incluyas en frontend público, capturas ni Git.

Sustituye YOUR_PROJECT_ID y YOUR_API_KEY, y ejecuta el comando desde la carpeta que contiene query.jpg.

curl -sS -X POST "https://platform.meowid.net/v1/projects/YOUR_PROJECT_ID/search?top_k=3&threshold=0.35" -H "Authorization: Bearer YOUR_API_KEY" -F "[email protected];type=image/jpeg"

En PowerShell, usa curl.exe. Para PNG o WebP, cambia también el nombre y el tipo MIME. El campo multipart debe llamarse image. No establezcas manualmente el Content-Type multipart completo: curl genera el boundary.

La búsqueda espera a que termine la tarea de reconocimiento y devuelve el resultado. Revisa el saldo y las tarifas antes de llamar.

Este ejemplo está abreviado y no es una respuesta literal:

{
  "cat_count": 1,
  "unknown": false,
  "matches": [{
    "cat_id": "example-cat-id",
    "cat_name": "Mimi",
    "score": 0.91,
    "support": 2
  }]
}

Comprueba unknown antes de usar un candidato. Si es true, no asignes una identidad automáticamente aunque haya candidatos. score es similitud, no probabilidad de acierto; support cuenta los vectores válidos que respaldan al candidato.

Si hay varios gatos, procesa cada elemento de candidates. El resultado principal solo representa al primer gato detectado. Si cat_count es 0, no accedas a matches[0].

Para automatizar el registro, añade cats:write y tasks:read a la clave. Conserva recognition:write si también ejecutarás búsquedas.

Ejemplo de perfil con metadata:

{
  "name": "Mimi",
  "metadata": {
    "personality": "Friendly, loves sunny spots",
    "notes": "Add fields that suit your application"
  },
  "active": true
}

personality y notes son campos definidos por tu aplicación, no inferidos por el modelo. Usa cat_id para vincularlos con tus datos. Si la tarea no está en la primera página, aumenta el offset. Resuelve waiting_user en la consola y revisa el error de las tareas failed.

Tras completar el registro puedes añadir gatos y fotos sin volver a entrenar el modelo.

Consulta la documentación completa para desarrolladores.