Pinit

El servicio **TrueAddress AI** permite procesar direcciones escritas en texto libre para limpiarlas, descomponerlas en componentes estructurados y, de forma opcional, validarlas y geocodificarlas. Utiliza inteligencia artificial para mejorar la precisión en la estandarización de direcciones y facilita su uso en sistemas logísticos y de análisis geoespacial.
**Consideraciones adicionales:**
- El servicio está diseñado principalmente para direcciones en **México y Colombia**. - El parámetro `enable_validation` usa un catálogo interno de **códigos postales**. - La geocodificación puede usar **distintos proveedores** según umbral de confianza. - El campo `score` indica la **confianza del resultado** (entre 0 y 1). - Si `enable_validation` es `true`, la validación se usa internamente pero **no aparece en la respuesta**. - Para soporte o autenticación, **contacta al equipo técnico de Pinit**.


TrueAddress AI

Descripción general

Flujo básico de uso

POST /true-address-ai

Consideraciones adicionales

Preguntas frecuentes

Clusters Inteligentes

Autenticación

POST /clusters

GET /clusters/{uuid}

Recomendaciones para configurar el clustering

Archivos generados

Ejemplo de petición POST /clusters

Route Solver

POST /route-solver

Recomendaciones y buenas prácticas

Ejemplos de peticiones POST /route-solver

Multi Route Solver

POST /multi-route-solver

POST /multi-route-solver/asynchronous

GET /multi-route-solver/solution/{job_id}

Ejemplo de petición POST /multi-route-solver

Blur it

POST /blur-it

Tipos de blur

Default

servicios

Production

<p class="slate-p " ><span class="slate-color" style="color:#9900FF"><strong class="slate-bold">Blur It</strong></span> es un servicio de anonimización de rostros en imágenes. <strong class="slate-bold">Detecta caras automáticamente y les aplica un efecto de </strong><em class="slate-italic"><strong class="slate-bold">blur</strong></em><strong class="slate-bold"> para proteger la identidad</strong> de las personas.</p><h2 class="slate-h2 " >¿Para qué sirve?</h2><p class="slate-p " >El servicio recibe una imagen, detecta los rostros presentes y devuelve una nueva imagen con las caras difuminadas. Es útil en escenarios donde se necesita proteger la privacidad de las personas, como evidencias fotográficas de entregas logísticas.</p><h2 class="slate-h2 " >Características principales</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Detección automática de rostros: </strong>No necesitas indicar dónde estan las caras. El servicio las encuentra por ti.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Tres tipos de blur disponibles:</strong> Gaussian (difuminado suave), Pixelate (efecto mosaico) y Solid (bloqueo solido). Puedes elegir el que mejor se ajuste a tu caso de uso. Consulta la seccion <a href="69b330801e1e9aef04aab432/69b49f7d82e753c85e5db775" target="">Tipos de blur</a> para ver ejemplos visuales y detalles de cada uno.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Deteccion multi-rotacion:</strong> El servicio analiza la imagen en distintas orientaciones (0, 90, 180, 270 grados). Esto permite detectar rostros incluso en fotos giradas, como las tomadas con celular en distintas posiciones.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Dos formas de enviar la imagen:</strong> Puedes enviar la imagen como URL o codificada en base64.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Dos formas de recibir el resultado: </strong>La imagen procesada puede devolverse como URL temporal (disponible durante 24 horas) o en base64.</div></li></ul><p class="slate-p " ></p>

 es un servicio de anonimización de rostros en imágenes. 

Detecta caras automáticamente y les aplica un efecto de 

El servicio recibe una imagen, detecta los rostros presentes y devuelve una nueva imagen con las caras difuminadas. Es útil en escenarios donde se necesita proteger la privacidad de las personas, como evidencias fotográficas de entregas logísticas.

<p class="slate-p " >Todas las peticiones al servicio requieren autenticacion mediante un token Bearer.</p><h2 class="slate-h2 " >¿Cómo obtener tu token?</h2><p class="slate-p " >Para obtener tus credenciales de acceso, contacta al equipo de ventas de Pinit. Ellos te proporcionaran el token necesario para consumir el servicio.</p><h2 class="slate-h2 " >¿Cómo usarlo?</h2><p class="slate-p " >Incluye el token en el header <code class="slate-code">Authorization</code> de cada peticion:</p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">HTTP</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"></textarea><code class="language-http keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">Authorization: Bearer &lt;tu-token&gt;
</div>
</div></code></pre></div><h2 class="slate-h2 " >Consideraciones</h2><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">El token es <strong class="slate-bold">obligatorio</strong> en todas las solicitudes. </div></li><li class="slate-li " ><div style="position:relative">El token es único por cliente y debe mantenerse confidencial. </div></li><li class="slate-li " ><div style="position:relative">Un token inválido, expirado o ausente resultará en una respuesta <code class="slate-code">401 Unauthorized</code>.</div></li></ul><p class="slate-p " ></p>

Todas las peticiones al servicio requieren autenticacion mediante un token Bearer.

Para obtener tus credenciales de acceso, contacta al equipo de ventas de Pinit. Ellos te proporcionaran el token necesario para consumir el servicio.

<p class="slate-p " ><strong class="slate-bold">POST</strong> <code class="slate-code">https://services.pinittms.com/blur-it</code></p><p class="slate-p " >Este es el endpoint principal del servicio. Recibe una imagen, detecta los rostros y devuelve la imagen con las caras difuminadas.</p><h2 class="slate-h2 " >Antes de empezar</h2><p class="slate-p " >Algunos puntos clave sobre el servicio:<br><strong class="slate-bold">Imagen de entrada</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Se debe enviar <code class="slate-code">image_url</code> o <code class="slate-code">image_base64</code>, pero no ambos. Uno de los dos es obligatorio.</div></li><li class="slate-li " ><div style="position:relative">La imagen no debe exceder 4096x4096 pixeles. Si supera ese limite, el servicio respondera con el error <code class="slate-code">IMAGE_TOO_LARGE</code>.</div></li><li class="slate-li " ><div style="position:relative">El campo image_base64 no debe superar los 10 MB.</div></li></ul><p class="slate-p " ><strong class="slate-bold">Tipos de blur</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">El servicio ofrece tres tipos de blur: <code class="slate-code">gaussian</code>, <code class="slate-code">pixelate</code> y <code class="slate-code">solid</code>. Consulta la seccion <a href="69b330801e1e9aef04aab432/69b49f7d82e753c85e5db775" target="">Tipos de blur</a> para ver ejemplos visuales y detalles de cada uno.</div></li></ul><p class="slate-p " ><strong class="slate-bold">Campos especificos en la respuesta</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><code class="slate-code">kernel_size</code>: Aparece en las detecciones solo cuando se usa blur gaussiano. Indica el tamaño del kernel usado para el difuminado. Se calcula automáticamente según el tamaño del rostro.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">block_size</code>: Aparece en las detecciones solo cuando se usa blur pixelate. Indica el tamano del bloque en pixeles usado para el efecto mosaico.</div></li></ul><p class="slate-p " ><strong class="slate-bold">Manejo de errores</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">El servicio puede responder con status HTTP 200 incluso cuando ocurre un error. Siempre valida el campo <code class="slate-code">success</code> en el body para confirmar si la peticion se proceso correctamente.</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">IMAGE_TOO_LARGE</code>: La imagen excede las dimensiones máximas permitidas (4096x4096 pixeles).</div></li><li class="slate-li " ><div style="position:relative"><code class="slate-code">IMAGE_LOAD_ERROR</code>: No se pudo cargar la imagen. La URL puede ser invalida, inaccesible o no apuntar a una imagen.</div></li></ul><p class="slate-p " ></p>

Este es el endpoint principal del servicio. Recibe una imagen, detecta los rostros y devuelve la imagen con las caras difuminadas.

URL HTTP/HTTPS de la imagen. Máximo 2048 caracteres.

image_url

Imagen codificada en base64 en formato data URI (ej: `data:image/jpeg;base64`). Maximo 10 MB.

image_base64

Tipo de blur a aplicar: "gaussian", "pixelate" o "solid".

blur_type

Formato en que se devuelve la imagen procesada: "url" o "base64".

response_image_type

Content-Type

Token de acceso en formato Bearer <token>.

Authorization

Indica si la peticion se proceso correctamente. `true` si fue exitosa, `false` si hubo un error.

success

image

Arreglo con la información de cada rostro detectado.

detections

summary

Cuando la petición es exitosa, el servicio responde con un `200 OK` y un JSON con tres bloques principales: `image`, `detections`y `summary`.

message

error

La imagen excede las dimensiones máximas permitidas (4096x4096 pixeles).

No se pudo cargar la imagen. Puede ser una URL invalida, inaccesible o que no apunta a una imagen.

errors

<p class="slate-p " >El servicio ofrece tres opciones de <em class="slate-italic">blur</em>. Cada una produce un resultado visual diferente. Elige la que mejor se adapte a tu caso de uso.</p><h3 class="slate-h3 " >Gaussian</h3><p class="slate-p " >Aplica un difuminado suave sobre el rostro usando una distribucion gaussiana. El resultado es natural y profesional. Es la opcino por defecto.</p><p class="slate-p " >Valor en el request: <code class="slate-code">&quot;blur_type&quot;: &quot;gaussian&quot;</code></p><div style="text-align:center"><figure ><div style="display:inline-block"><img src="https://raw.githubusercontent.com/corinacerezo/imagenes/refs/heads/main/image-01-blur-gaussian.jpg" alt="" style="width:1019.2px;height:633px;aspect-ratio:1019.2 / 633" /></div></figure></div><h3 class="slate-h3 " >Pixelate</h3><p class="slate-p " >Aplica un efecto de mosaico sobre el rostro. Los bloques de pixeles ocultan los rasgos faciales.<br>Valor en el request: <code class="slate-code">&quot;blur_type&quot;: &quot;pixelate&quot;</code></p><div style="text-align:center"><figure ><div style="display:inline-block"><img src="https://raw.githubusercontent.com/corinacerezo/imagenes/refs/heads/main/image-01-blur-pixelate.jpg" alt="" style="width:1019.2px;height:633px;aspect-ratio:1019.2 / 633" /></div></figure></div><h3 class="slate-h3 " >Solid</h3><p class="slate-p " >Cubre el rostro con un rectangulo negro solido. Es la opcion con mayor nivel de anonimización, ya que no deja visible nada.<br>Valor en el request: <code class="slate-code">&quot;blur_type&quot;: &quot;solid&quot;</code></p><div style="text-align:left"><figure ><div style="display:inline-block"><img src="https://raw.githubusercontent.com/corinacerezo/imagenes/refs/heads/main/image-01-blur-solid.jpg" alt="" style="width:1019.2px;height:633px;aspect-ratio:1019.2 / 633" /></div></figure></div><h3 class="slate-h3 " >Ejemplos adicionales</h3><p class="slate-p " >El servicio detecta rostros en distintas condiciones: multiples personas en una misma imagen, rostros parcialmente cubiertos (como con cubrebocas) y rostros en angulo o inclinados.</p><div class=card-group-box style="width:100%; min-width:540px;"><div class="card-box without-icon"><div ><h3 class="slate-h3 " >Imagen origial</h3><div style="text-align:left"><figure ><div style="display:inline-block"><img src="https://raw.githubusercontent.com/corinacerezo/imagenes/refs/heads/main/image-02.png" alt="" style="width:385.6px;height:514px;aspect-ratio:385.6 / 514" /></div></figure></div></div></div><div class="card-box without-icon"><div ><h3 class="slate-h3 " >Blur “pixelate”</h3><div style="text-align:left"><figure ><div style="display:inline-block"><img src="https://raw.githubusercontent.com/corinacerezo/imagenes/refs/heads/main/image-02-blur-pixelate.jpg" alt="" style="width:385.6px;height:514px;aspect-ratio:385.6 / 514" /></div></figure></div></div></div></div><div class=card-group-box style="width:100%; min-width:540px;"><div class="card-box without-icon"><div ><h3 class="slate-h3 " >Imagen original</h3><div style="text-align:left"><figure ><div style="display:inline-block"><img src="https://raw.githubusercontent.com/corinacerezo/imagenes/refs/heads/main/image-03.png" alt="" style="width:644px;height:463px;aspect-ratio:644 / 463" /></div></figure></div></div></div><div class="card-box without-icon"><div ><h3 class="slate-h3 " >Blur “gaussian”</h3><div style="text-align:left"><figure ><div style="display:inline-block"><img src="https://raw.githubusercontent.com/corinacerezo/imagenes/refs/heads/main/image-03-blur-gaussian.jpg" alt="" style="width:644px;height:463px;aspect-ratio:644 / 463" /></div></figure></div></div></div></div><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

. Cada una produce un resultado visual diferente. Elige la que mejor se adapte a tu caso de uso.

Aplica un difuminado suave sobre el rostro usando una distribucion gaussiana. El resultado es natural y profesional. Es la opcino por defecto.

Aplica un efecto de mosaico sobre el rostro. Los bloques de pixeles ocultan los rasgos faciales.
Valor en el request: 

Cubre el rostro con un rectangulo negro solido. Es la opcion con mayor nivel de anonimización, ya que no deja visible nada.
Valor en el request: 

El servicio detecta rostros en distintas condiciones: multiples personas en una misma imagen, rostros parcialmente cubiertos (como con cubrebocas) y rostros en angulo o inclinados.

<h4 class="slate-h4 " >Valida siempre el campo <code class="slate-code">success</code></h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">El servicio puede responder con HTTP 200 incluso cuando hay un error. Antes de usar la imagen resultante, verifica que <code class="slate-code">success</code> sea <code class="slate-code">true</code>.</div></li></ul><h4 class="slate-h4 " >Verifica las dimensiones antes de enviar</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">La imagen no debe superar 4096x4096 pixeles. Si trabajas con fotos de alta resolución, redimensiona la imagen antes de enviarla para evitar errores innecesarios.</div></li><li class="slate-li " ><div style="position:relative">Si requieres que el servicio soporte imágenes más grandes, contacta el equipo de Pinit.</div></li></ul><h4 class="slate-h4 " >Usa image_url cuando sea posible</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Si tu imagen ya esta disponible en una URL pública, enviarla como <code class="slate-code">image_url</code> es más eficiente que convertirla a base64. Reduces el tamaño del request y el tiempo de transferencia.</div></li></ul><h4 class="slate-h4 " >Descarga la imagen resultante pronto</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Cuando usas <code class="slate-code">response_image_type: &quot;url&quot;</code>, <strong class="slate-bold">la URL generada es temporal y expira en 24 horas</strong>. Descarga o almacena la imagen en tu propio sistema antes de que expire.</div></li></ul><h4 class="slate-h4 " >Elige el tipo de blur según tu necesidad</h4><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">No todos los escenarios requieren el mismo nivel de anonimización. Usa gaussian para un resultado natural, pixelate para un estilo editorial, y solid cuando necesites la máxima protección de identidad.</div></li></ul><p class="slate-p " ></p>

Elige el tipo de blur según tu necesidad

<p class="slate-p " >En esta sección encontrarás respuestas a las dudas más comunes sobre el uso de <strong class="slate-bold">Blur it.</strong></p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué pasa si la imagen no tiene ningún rostro?</strong></h4><p class="slate-p " >El servicio responde con <code class="slate-code">success: true</code>, pero el arreglo <code class="slate-code">detections</code> estará vacio y <code class="slate-code">summary.faces_detected</code> sera 0. La imagen devuelta sera identica a la original, sin modificaciones.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Puedo enviar </strong><code class="slate-code"><strong class="slate-bold">image_url</strong></code><strong class="slate-bold"> y </strong><code class="slate-code"><strong class="slate-bold">image_base64</strong></code><strong class="slate-bold"> al mismo tiempo?</strong></h4><p class="slate-p " >No. Debes enviar uno de los dos, pero no ambos. Si necesitas cambiar de metodo entre peticiones, simplemente usa el campo correspondiente en cada request.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Cuánto tarda el servicio en procesar una imagen?</strong></h4><p class="slate-p " >Depende del tamaño de la imagen y la cantidad de rostros. En general, el tiempo de procesamiento es de unos cientos de milisegundos. Puedes consultar el valor exacto en <code class="slate-code">summary.processing_time_ms</code> de cada respuesta.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Detecta rostros con cubrebocas, lentes o parcialmente cubiertos?</strong></h4><p class="slate-p " >Si. El servicio puede detectar rostros parcialmente cubiertos, aunque el nivel de confianza (confidence) puede ser menor en estos casos.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Detecta rostros en imagenes giradas?</strong></h4><p class="slate-p " >Si. Por defecto, el servicio analiza la imagen en cuatro orientaciones (0, 90, 180 y 270 grados). Esto permite detectar rostros en fotos tomadas con el celular en distintas posiciones.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿La URL de la imagen procesada es permanente?</strong></h4><p class="slate-p " >No. Las URLs generadas cuando usas <code class="slate-code">response_image_type: &quot;url&quot;</code> expiran en 24 horas. Descarga la imagen antes de que expire.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿El servicio almacena mis imagenes?</strong></h4><p class="slate-p " >No. El servicio no almacena las imagenes de forma permanente. Las URLs temporales se generan para la entrega del resultado y expiran en 24 horas.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Qué formatos de imagen soporta?</strong></h4><p class="slate-p " >El servicio acepta los formatos de imagen mas comunes como JPEG, PNG y WebP.</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><h4 class="slate-h4 " ><strong class="slate-bold">¿Puedo usar el servicio para video?</strong></h4><p class="slate-p " >No. El servicio procesa imagenes individuales. Para video, tendrias que extraer los frames, procesarlos uno por uno y reconstruir el video por tu cuenta.</p>

En esta sección encontrarás respuestas a las dudas más comunes sobre el uso de 

¿Qué pasa si la imagen no tiene ningún rostro?

 sera 0. La imagen devuelta sera identica a la original, sin modificaciones.

No. Debes enviar uno de los dos, pero no ambos. Si necesitas cambiar de metodo entre peticiones, simplemente usa el campo correspondiente en cada request.

¿Cuánto tarda el servicio en procesar una imagen?

Depende del tamaño de la imagen y la cantidad de rostros. En general, el tiempo de procesamiento es de unos cientos de milisegundos. Puedes consultar el valor exacto en 

¿Detecta rostros con cubrebocas, lentes o parcialmente cubiertos?

Si. El servicio puede detectar rostros parcialmente cubiertos, aunque el nivel de confianza (confidence) puede ser menor en estos casos.

Si. Por defecto, el servicio analiza la imagen en cuatro orientaciones (0, 90, 180 y 270 grados). Esto permite detectar rostros en fotos tomadas con el celular en distintas posiciones.

¿La URL de la imagen procesada es permanente?

 expiran en 24 horas. Descarga la imagen antes de que expire.

No. El servicio no almacena las imagenes de forma permanente. Las URLs temporales se generan para la entrega del resultado y expiran en 24 horas.

El servicio acepta los formatos de imagen mas comunes como JPEG, PNG y WebP.

No. El servicio procesa imagenes individuales. Para video, tendrias que extraer los frames, procesarlos uno por uno y reconstruir el video por tu cuenta.

Sections