Check text position against platform UI
check_text_positionChecks whether a rectangular text box (caption, title or logo) on a vertical video frame stays inside the safe zone of Instagram Reels, TikTok, YouTube Shorts or Instagram Stories. Reports which interface element it overlaps (top bar, bottom caption area, right button column, edge margins, optionally the Reels comment-reply sticker) and suggests the nearest position that clears them. Coordinates are pixels from the top-left corner of the frame.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Left edge of the text box in pixels, measured from the left of the frame. | |
| y | Yes | Top edge of the text box in pixels, measured from the top of the frame. | |
| width | Yes | Text box width in pixels. | |
| height | Yes | Text box height in pixels. | |
| platform | Yes | Vertical video platform: 'reels' (Instagram Reels), 'tiktok', 'shorts' (YouTube Shorts), 'story' (Instagram Stories) or 'all' (the strictest margins of all four combined). | |
| canvas_width | No | Frame width in pixels. Default 1080. | |
| canvas_height | No | Frame height in pixels. Default 1920. | |
| include_comment_sticker | No | Reels only: also test against the comment-reply sticker band (approximately y 300-560 px on 1080x1920). Default false. |