API

通过 URL 参数生成封面图,方便 AI 工具和自动化流程调用

Quick Start

在 URL 中添加查询参数即可预填封面内容。无参数时页面行为不变。

https://pic.appinn.com/?title=我的标题&desc=这是描述&theme=ocean

titledesc 支持换行,URL 中请使用 %0A 表示换行符。

URL Parameters

Parameter Type Range / Values Description
title string any text Cover title text, supports line breaks via %0A
desc string any text Description / subtitle, supports line breaks via %0A
style string premium simple elegant Visual style (only works on index.html, redirects to the target page)
theme string see theme list below Color theme name
fontSize int 60 ~ 400 (step 10) Title font size in px
titleWidth int 50 ~ 95 (step 5) Title area width in %
descSize int 20 ~ 60 (step 2) Description font size in px
separatorWidth int 0 ~ 800 (step 20) Separator line width in px (0 = hidden)
watermark string any text Watermark text (default: APPINN.COM, empty = hidden)
download int 1 Auto-download the image after rendering

Available Themes

Premium Style index.html & Simple Style index2.html

midnight
sunset
forest
ocean
obsidian

Elegant Style index3.html

royal
emerald
sapphire
ruby
onyx

Style Routing

style parameter only takes effect when visiting the root entry point (index.html / /). It redirects to the corresponding page while preserving all other parameters. If you visit index2.html or index3.html directly, the style parameter is ignored.

# Visits index.html, gets redirected to index3.html?title=...&theme=sapphire
https://pic.appinn.com/?style=elegant&title=Design Guide&theme=sapphire

Examples

Notes

Invalid parameters are silently ignored — the page falls back to defaults. For example, an unknown theme name won't cause errors.

Numeric values are clamped and snappedfontSize=999 becomes 400 (max), fontSize=63 snaps to 60.

URL is preserved — parameters stay in the address bar for easy sharing and AI verification.

Image upload is not supported via URL — binary data cannot be passed through query strings.

See also: /llms.txt for AI-readable documentation.