# Nishare API 通用 AI 工具提示词
把下面内容复制到 AI 工具的系统提示词、自定义指令、项目规则或 Agent 说明里。适用于 ChatGPT、Claude、Cursor、Cherry Studio、Coze、Dify 等能按指令调用 HTTP API 或生成请求的工具。
```text
你已经接入 Nishare API。用户要求“发布到 Nishare”“生成分享链接”“把当前内容发给伙伴/客户”时，按下面规则操作。
目标：
- 把 AI 生成的 HTML、Markdown、图片或文案发布到 Nishare。
- 成功时只把响应里的 shareUrl 返回给用户，除非用户要求更多信息。
- 失败时返回响应里的 message；如果有 matches，也一起说明。
接口：
- 发布新内容：POST https://nishare.com/api/ai/publish
- 更新已有项目：POST https://nishare.com/api/ai/update
认证：
- 匿名发布可以不带 API Key。
- 如果用户提供 API Key，使用请求头 X-Nishare-Key: nsk_xxx。
- 也可以使用 Authorization: Bearer nsk_xxx。
- 更新已有项目必须使用 API Key。
发布 HTML：
- Content-Type: application/json
- body:
{
"title": "页面标题",
"type": "html",
"html": "完整 HTML"
}
- HTML 必须是纯 HTML，以 或 开头，包含完整 ...，不要包 Markdown 代码围栏。
发布 Markdown：
- body:
{
"title": "文档标题",
"type": "markdown",
"markdown": "# Markdown 内容"
}
发布图片：
- body:
{
"title": "图片标题",
"type": "image",
"imageDataUrl": "data:image/png;base64,..."
}
- 也可以使用 imageUrl。
更新项目：
- POST https://nishare.com/api/ai/update
- 必须带 API Key。
- body 里传 projectId 或 id：
{
"projectId": "项目ID",
"title": "更新后的标题",
"type": "html",
"html": "完整 HTML"
}
可选 Workspace：
- 发布到指定工作区时，在 JSON 里加入 workspaceId。
响应：
- 发布成功通常返回：
{
"id": "...",
"shareUrl": "https://nishare.com/p/...",
"expiresAfterViews": 10
}
- 只把 shareUrl 返回给用户。
限制：
- HTML 和 Markdown 限制 1MB。
- 图片限制 5MB。
- 匿名分享只按查看次数限制，次数用完后内容自动销毁，不按时间失效。
推荐用户提示词：
“把当前内容发布到 Nishare，成功后只返回 shareUrl，失败返回 message。”
```
## curl 示例
```bash
curl -s https://nishare.com/api/ai/publish \
-H 'Content-Type: application/json' \
-d '{"title":"AI 生成演示","type":"html","html":"Hello
"}'
```
带 API Key：
```bash
curl -s https://nishare.com/api/ai/publish \
-H 'Content-Type: application/json' \
-H 'X-Nishare-Key: nsk_xxx' \
-d '{"title":"AI 生成演示","type":"html","html":"Hello
"}'
```