API & CLI

AI / CLI 一键发布

不用复制页面上所有命令——按场景选一次，只复制下面出现的那一条即可。

只需 1 条命令发布需注册私密需鉴权

Quick Start · 90% 场景

选「公开」或「私密」→ 复制一条 curl → 拿到 share_url

API Token · 私密 / 团队发布

发布（公开/私密/团队）都需注册账号，并在 curl 的 Authorization 头中使用下方 Token（每账号唯一）。

请登录后生成 Token，或在私密 curl 中使用邮箱 + 登录密码。

选你的场景

只会显示对应的一条命令

第 1 步 · 分享方式

第 2 步 · 身份验证

curl -X POST "https://htmlai.cn/api/v1/publish/json" \
  -H "Authorization: Bearer hsh_你的token"
  -H "Content-Type: application/json" \
  -d '{"title":"AI Demo","html":"<!DOCTYPE html><html><body>Hello</body></html>","visibility":"public"}'

curl -X POST "https://htmlai.cn/api/v1/publish/json" \
  -H "Authorization: Bearer hsh_你的token" \
  -H "Content-Type: application/json" \
  -d '{"title":"内部报告","html":"<!DOCTYPE html>...","visibility":"private","access_password":"我的密码123","auto_password":false}'

curl -X POST "https://htmlai.cn/api/v1/publish/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"你的登录密码","title":"内部报告","html":"<!DOCTYPE html>...","visibility":"private","access_password":"我的密码123"}'

curl -X POST "https://htmlai.cn/api/v1/publish/json" \
  -H "Authorization: Bearer hsh_你的token" \
  -H "Content-Type: application/json" \
  -d '{"title":"内部看板","html":"<!DOCTYPE html>...","visibility":"workspace"}'

成功后返回：title + share_url + password + share_text（标题+链接+密码）

其他发布方式（可选，一般不需要）

如果你已经有本地 .html 文件、或想用 CLI，可以用下面方式——同样只选一种复制即可。

上传本地文件

curl -X POST "https://htmlai.cn/api/v1/publish" \
  -F "file=@index.html" -F "title=Demo" -F "visibility=public"

CLI · `hsh`

hsh publish index.html --title "AI Demo" --visibility public

本地运行：./scripts/hsh publish … · 加入 PATH：ln -sf $(pwd)/scripts/hsh ~/.local/bin/hsh

选你的场景

上传本地文件

CLI · hsh

CLI · `hsh`