Media objects

Un media_object representa un activo creativo dentro de Polimake. Puede ser una imagen, video, audio, documento, presentacion u otro archivo gestionado por el sistema.

Estructura base

{
  "id": "media_01HX9R8K4Q2Z4T",
  "object": "media_object",
  "project_id": "brand-assets",
  "filename": "equipo-oficina-campana.jpg",
  "mime_type": "image/jpeg",
  "size_bytes": 2483912,
  "status": "ready",
  "created_at": "2026-06-04T10:00:00Z",
  "updated_at": "2026-06-04T10:01:12Z",
  "urls": {
    "preview": "https://cdn.polimake.com/previews/media_01HX9R8K4Q2Z4T.webp",
    "thumbnail": "https://cdn.polimake.com/thumbnails/media_01HX9R8K4Q2Z4T.webp"
  },
  "metadata": {
    "width": 2400,
    "height": 1600,
    "duration_seconds": null
  },
  "ai": {
    "description": "Equipo trabajando en una oficina luminosa con portatiles y material de marca.",
    "tags": ["equipo", "oficina", "trabajo", "colaboracion", "marca"],
    "objects": ["persona", "portatil", "mesa"],
    "suggested_uses": ["web", "presentacion", "campana employer branding"]
  }
}

Campos principales

Campo	Tipo	Descripcion
id	string	Identificador unico del archivo.
object	string	Tipo de objeto. En este caso, media_object.
project_id	string	Proyecto al que pertenece el activo.
filename	string	Nombre original o normalizado del archivo.
mime_type	string	Tipo MIME detectado.
size_bytes	number	Peso del archivo en bytes.
status	string	Estado de procesamiento.
urls	object	URLs disponibles para preview, thumbnail o descarga segun permisos.
metadata	object	Metadata tecnica del archivo.
ai	object	Resultado del analisis IA cuando esta disponible.

Estados

• uploading: el archivo se esta recibiendo.
• processing: se estan generando previews, thumbnails o analisis.
• ready: el archivo esta disponible para busqueda y uso.
• failed: el procesamiento fallo.
• deleted: el archivo fue eliminado o marcado para eliminacion.

Metadata IA

La propiedad ai puede incluir:

• description: descripcion natural del recurso.
• tags: etiquetas de busqueda.
• objects: objetos detectados.
• people: senales sobre presencia de personas, si aplica.
• logos: logos o marcas detectables, si aplica.
• suggested_uses: usos recomendados.
• safety_notes: notas de revision, derechos o privacidad, si estan configuradas.

Uso en busqueda

Las respuestas de busqueda devuelven una lista de media_object enriquecidos con score.

{
  "items": [
    {
      "id": "media_01HX9R8K4Q2Z4T",
      "object": "media_object",
      "score": 0.91,
      "filename": "equipo-oficina-campana.jpg",
      "ai": {
        "description": "Equipo trabajando en una oficina luminosa.",
        "tags": ["equipo", "oficina", "colaboracion"]
      }
    }
  ]
}