Instagram Photo Text Overlay

通过本地 Python 脚本在用户提供的照片上叠加渐变遮罩、标题、副标题与编号列表，输出 4:5 竖版 JPEG 图片。支持 list、clean、quote 三种样式，可配置水印、强调色、引文与输出质量，字体大小随图片宽度按比例缩放。

psyduckler

热度 88.12

最近更新 2026-05-11 17:26:03

分类：营销依赖：代码执行 / 读写文件应用场景：社交媒体 / 图像生成 / 品牌素材 / 模板

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add instagram-photo-text-overlay

Metadata

name: instagram-photo-text-overlay
description: Overlay text on photos for Instagram posts. Generates portrait (4:5) images with gradient overlays, titles, and optional numbered lists. Use when creating Instagram content that needs text on top of a photo — destination itineraries, top-5 lists, travel highlights, or any branded social image with text overlay.

Instagram Photo Text Overlay

Overlay text onto photos for Instagram-ready images. Two styles: list (title + numbered items) and clean (title only).

Quick Start

python3 scripts/overlay.py \
  --input photo.jpg \
  --output result.jpg \
  --title "TAORMINA" \
  --subtitle "3-Day Trip Itinerary" \
  --items '["Teatro Greco|Ancient theatre with Etna views", "Isola Bella|Crystal-clear beach"]' \
  --style list

Options

Flag	Default	Description
`--input`	(required)	Source photo path
`--output`	(required)	Output image path
`--title`	(required)	Main title (auto-uppercased)
`--subtitle`	`"3-Day Trip Itinerary"`	Subtitle below title
`--items`	`[]`	JSON array of `"Name\|Reason"` strings (list style)
`--watermark`	`"tabiji.ai"`	Top-left watermark (empty string to disable)
`--accent`	`255,220,150`	Accent color for numbers/tags (R,G,B)
`--quote`	`""`	Quote text (for quote style)
`--style`	`list`	`list` / `clean` / `quote`
`--quality`	`95`	JPEG output quality

Styles

clean: Cover slide. Big title = destination + category + count (e.g. "7 unique cheap eats in barcelona spain"). Subtitle = credibility/source line (e.g. "Insider takes from r/barcelona"). Best as carousel first slide.
list: Content slides. Title + subtitle + divider + numbered items with reasons. Best for top-5 / itinerary posts.
quote: Title with accent bar on the left + blockquote text below. No subtitle or divider. Best for travel quotes, testimonials, or key takeaways.

Workflow

Receive photo + destination/topic + list of items from user
Run scripts/overlay.py with appropriate args
Output is auto-cropped to 4:5 portrait (Instagram optimal)
Review output and adjust if needed (font sizes scale with image width)

Requirements

Python 3 + Pillow (pip install Pillow)
Works on macOS (Helvetica) and Linux (DejaVu/Liberation fallback)

Tips

Items format: "Name|Short reason" — the pipe separates bold name from description
For destinations, pull top picks from existing itineraries when available
Gradient + white text ensures readability on any photo
All font sizes are proportional to image width — works at any resolution