> ## Documentation Index
> Fetch the complete documentation index at: https://docs.my-aichatbot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Image

> The image block — a picture from a URL or an uploaded file_id.

A picture, from an `https://` URL or an uploaded `file_id`.

<ParamField body="type" type="string" required>
  `"image"`
</ParamField>

<ParamField body="url" type="string">
  An `https://` URL, up to 2,048 characters. **You must send exactly one of `url` or `file_id`.**
</ParamField>

<ParamField body="file_id" type="string">
  An id from [uploading a file](/sending-messages/files).
</ParamField>

<ParamField body="alt" type="string">
  Up to 200 characters. Empty means the image is decoration only.
</ParamField>

<ParamField body="caption" type="string">
  Plain text, up to 500 characters. Shown under the image.
</ParamField>

```json theme={null}
{
  "type": "image",
  "file_id": "6f1c2a84",
  "alt": "June revenue chart",
  "caption": "Revenue by week, June 2026"
}
```

<Warning>
  Sending both `url` and `file_id`, or neither, is an error. Pick one.
</Warning>

A broken image link shows a placeholder with your `alt` text — never an empty gap. Uploaded images get a fresh short-lived link each time the message is read.