You can let Heptabase AI read your images in the following ways:
On a whiteboard, right-click an image element or image card and choose New chat / Add to chat
In Chat, click the
+button and add the image card you want the AI to readPaste an image directly into the chat
At the moment, these are the supported ways to pass images into AI chat. Mentioning a card alone does not make the AI read images inside that card.
Image upload limits
Image limits depend on the AI model used for the request. For each request, we apply limits to:
maximum size per image
maximum total image size
maximum number of images
OpenAI
Max size per image: 20 MB
Max total image size per request: 45 MB
Max number of images: 100
Anthropic
Max size per image: 4.75 MB
Max total image size per request: 28 MB
Max number of images: 80
Gemini
Max size per image: 4.75 MB
Max total image size per request: 14 MB
Max number of images: 80
Important limitations
Please note that the following is not currently supported:
Mentioning a card and expecting the AI to read images embedded inside that card
Using one card reference as a shortcut for all embedded content inside it
If your request exceeds the model’s limits, it may fail. This can happen when:
one image is too large
the combined size of all images is too large
too many images are included in a single request
If that happens, try reducing image size, sending fewer images, or splitting them into multiple requests. The current workaround is to add each image directly through a supported image route instead of relying on a card mention.