Solicitud cURL
POST /api/v1/image/profilecurl -X POST "https://avatarlookup.com/api/v1/image/profile" \
-H "X-API-Key: sk_your_api_key" \
-F "file=@avatar.jpg"
product image_profile
Análisis de perfil de imágenes
Suba cualquier imagen y obtenga sus atributos de retrato: edad estimada, género, tipo de imagen, color de cabello y tono de piel.
Coste de uso: 0,002 $ / verificaciónModo de respuesta: Síncrono
POST /api/v1/image/profileContrato de la API
Una solicitud, resultado inmediato
Suba una imagen como campo de archivo multipart llamado file. La autenticación usa su clave API.
Copie el siguiente comando curl y sustituya únicamente la clave API de ejemplo por la suya.
Respuesta
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "image_profile",
"identifier": "img:7013df96c540904a4b7ba295e9162ab2",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}Cómo usarlo
Tres claves del análisis de imágenes
Envíe la propia imagen
Una imagen por solicitud, como campo de archivo multipart llamado file. JPEG, PNG, WebP o GIF, hasta 2 MB. No interviene ningún número ni email: la respuesta describe la imagen, no una cuenta.
Lea category antes que el resto
category le indica qué es la imagen. Las imágenes de mascotas, dibujos animados, paisajes u objetos se analizan y se cobran, pero no incluyen los campos de edad ni de género.
No conservamos la imagen
La imagen pasa directamente al análisis y nunca se almacena. identifier es una huella derivada del contenido de la imagen, de modo que la misma imagen siempre produce el mismo valor; úsela para eliminar duplicados por su parte.
Qué verifica
¿Qué devuelve Análisis de perfil de imágenes?
Campos devueltos
identifier· string — Huella de la imagen enviada, derivada de su contenido. La misma imagen siempre produce el mismo valor.category· string — Qué es la imagen: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar o object. unknown cuando no se ha podido obtener un retrato.age· integer — Edad estimada como número entero, con una precisión de unos 3 años y limitada al rango 0-80. Se omite cuando no se ha podido estimar (por ejemplo, cuando no se determinó el género).gender· string — male, female o unknown.skin_color· string — Tono de piel descriptivo, por ejemplo white, east_asian o hispanic. Trátelo como un conjunto abierto; unknown cuando no se ha determinado.hair_color· string — Color de cabello descriptivo, por ejemplo black, brown, blond o gray white. Trátelo como un conjunto abierto; unknown cuando no se ha determinado.
Ideal para
Use este producto cuando necesite
Archivos de avatares existentes
Añada huellas, tipos de imagen y atributos de retrato coherentes a avatares e imágenes históricos, reduciendo la revisión y la clasificación manuales.
Perfilado de audiencias
Organice los recursos por tipo de imagen, edad estimada, género y color de cabello y de piel para examinar la composición de una colección y recuperar registros más adelante.
Triaje de moderación de contenido
Identifique primero retratos, fotos de grupo, dibujos animados, mascotas, paisajes y objetos, y después dirija cada imagen al flujo de revisión manual adecuado.
Enriquecimiento de datos
Escriba los resultados del análisis en los datos de clientes, contenidos o recursos para que los registros que solo tenían una imagen ganen campos estructurados para filtrar.
Respuesta directa
¿Qué es Análisis de imágenes?
Análisis de perfil de imágenes devuelve los atributos de la propia imagen: tipo de imagen, género, edad estimada, tono de piel y color de cabello. Envíe una imagen al endpoint de imágenes como campo de archivo multipart llamado file y lea los atributos de retrato en el nivel superior de la misma respuesta de la API. No interviene ningún identificador.
Límites claros
Lo que no devuelve
- Describe la imagen, no a una persona ni una cuenta: el resultado no afirma nada sobre registro, accesibilidad o identidad.
- La edad, el género, el tono de piel y el color de cabello son estimaciones algorítmicas a partir de una sola imagen. Trátelos solo como señales de apoyo, nunca como base para la verificación de identidad, un filtrado discriminatorio o cualquier decisión de alto impacto.
- Las imágenes sin sujeto humano también devuelven un resultado y también se cobran. Solo son gratuitos un error del servicio, una imagen que no podemos obtener o leer, o una respuesta del modelo sin ningún campo.
Preguntas frecuentes del producto
Preguntas sobre Análisis de imágenes
¿Qué devuelve Análisis de perfil de imágenes?
Devuelve los atributos de la propia imagen: tipo de imagen, género, edad estimada, tono de piel y color de cabello en la misma respuesta síncrona.
¿Cómo funciona la facturación de Análisis de imágenes?
Se cobra saldo por cada imagen que devuelve un resultado, incluidas mascotas, dibujos animados y paisajes. Solo son gratuitos un error del servicio, una imagen que no podemos obtener o leer, o una respuesta del modelo sin ningún campo.
¿Qué formatos y tamaños de imagen se aceptan?
JPEG, PNG, WebP o GIF, hasta 2 MB por imagen. El tipo se determina a partir del propio contenido del archivo, no de su extensión.
¿Almacenan la imagen?
No. La imagen pasa directamente al análisis y nunca se escribe en disco ni en almacenamiento de objetos. Solo se conserva en el registro de la verificación la huella derivada de su contenido.
Productos relacionados
Otros productos de análisis de avatares
Empiece a verificar ahora
Cree una cuenta para usar todos los productos desde el panel SaaS o la API: las verificaciones en tiempo real y las verificaciones masivas asíncronas consumen el mismo saldo.