Build: integrar Polimake

Polimake combina producto web para equipos creativos con una capa de integracion pensada para conectar archivos, busqueda semantica, analisis IA y flujos de aprobacion con herramientas externas.

Esta seccion esta escrita para desarrolladores, integradores y agentes de IA que necesitan entender Polimake como sistema tecnico, no solo como herramienta de marketing.

Estado de la API

La API publica de Polimake debe tratarse como preview/beta hasta que el equipo publique credenciales, limites y contratos de produccion. Los ejemplos de esta seccion describen el contrato recomendado para integraciones, pero pueden cambiar antes de la disponibilidad general.

Si necesitas acceso a una integracion real, contacta con el equipo de Polimake desde la pagina de developers o desde los canales comerciales habituales.

Que puedes integrar

• Media objects: archivos, imagenes, videos, documentos y metadatos asociados.
• Busqueda semantica: encontrar recursos con lenguaje natural, no solo por nombre de archivo.
• Analisis IA: tags, descripciones, objetos, escenas, usos sugeridos y otros campos de metadata.
• Proyectos: separar repositorios de activos por cliente, marca, campana o equipo.
• Webhooks: reaccionar a subidas, analisis completados, cambios de estado y aprobaciones.
• Agentes internos: conectar Polimake con CRM, CMS, intranets, herramientas de ventas o copilotos privados.

Conceptos principales

Project

Un project agrupa archivos, permisos, busquedas, flujos y contexto de negocio. Para una agencia, suele mapearse a cliente o cuenta. Para una empresa, puede mapearse a marca, departamento o repositorio interno.

Media object

Un media_object representa un activo creativo: imagen, video, audio, documento, presentacion o recurso relacionado. Incluye metadata tecnica, URLs de preview, etiquetas, analisis IA, permisos y estado.

Semantic search

La busqueda semantica permite hacer consultas como:

presentacion para cliente de energia renovable con graficos de resultados

En vez de depender solo de nombres de archivo o carpetas, Polimake busca por significado, descripciones, tags, contenido visual y contexto del proyecto.

AI analysis

El analisis IA extrae campos utiles para organizar y reutilizar activos:

• Descripcion natural del contenido.
• Tags objetivos, esteticos y conceptuales.
• Objetos, escenas, personas o logos detectables.
• Usos recomendados.
• Riesgos o notas de revision si estan configuradas.

Base URL

Los ejemplos usan esta URL de preview:

https://api.polimake.com/v1

Ejemplo rapido

curl https://api.polimake.com/v1/media/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "brand-assets",
    "query": "logo sobre fondo blanco",
    "top_k": 10
  }'

Recursos para agentes

• Developer hub: /build
• Documentacion general: /docs
• OpenAPI preview: /openapi.json
• Resumen para agentes: /llms.txt

Siguientes pasos

Empieza por Autenticacion, revisa el modelo de media object y prueba el contrato de busqueda semantica.