Media objects

A media_object represents a creative asset within Polimake. It can be an image, video, audio, document, presentation, or another file managed by the system.

Base Structure

{
  "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"]
  }
}

Main Fields

Field	Type	Description
id	string	Unique identifier of the file.
object	string	Object type. In this case, media_object.
project_id	string	Project the asset belongs to.
filename	string	Original or normalized name of the file.
mime_type	string	Detected MIME type.
size_bytes	number	File size in bytes.
status	string	Processing status.
urls	object	URLs available for preview, thumbnail, or download depending on permissions.
metadata	object	Technical metadata of the file.
ai	object	Result of the AI analysis when available.

Statuses

• uploading: the file is being received.
• processing: previews, thumbnails, or analyses are being generated.
• ready: the file is available for search and use.
• failed: processing failed.
• deleted: the file was deleted or marked for deletion.

AI Metadata

The ai property can include:

• description: natural description of the resource.
• tags: search tags.
• objects: detected objects.
• people: signals about the presence of people, if applicable.
• logos: detectable logos or brands, if applicable.
• suggested_uses: recommended uses.
• safety_notes: review, rights, or privacy notes, if configured.

Use in Search

Search responses return a list of media_object items enriched with a 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"]
      }
    }
  ]
}

Continue with Build: integrate Polimake.