集成

从一个脚本或一个智能体生成文档

一个 REST API、一个 CLI,以及面向 Claude Code、Cursor 和其他智能体的智能体技能,调用的是和应用一样的那些操作。从视频生成文档、编辑文章并发布,单人版 / 小团队版及以上可用。

一次来自应用外部的调用
POST/api/external/v2/generate
202已接受,任务已进入队列

一个文档 API,八组端点

文章、文件夹、模板、视频、生成、项目设置、发布和导出都写在同一份 OpenAPI 规范里,浏览器和代码生成器读的也是这一份参考。翻译、版本恢复和重新生成就在这几组里面。

文章、文件夹和模板

创建、更新、移动和删除文章与文件夹,并读取模板,每个请求都用一个 X-API-Key 请求头来认证。
运作方式
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

先生成,再查任务

让生成端点指向一段视频,它就会排入一个任务。用任务 id 轮询它的状态,这和应用自己处理长耗时运行用的异步方式一样。
运作方式
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

项目设置与发布

读取和更新项目设置,并发布、重新发布或取消发布,走的是应用内设置页面用的同一条发布流水线。
运作方式
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

用带签名的回调代替轮询

在生成、重新生成、翻译或发布的调用里加上 callbackUrl,任务完成或失败时 Hinto 就会向它发送请求。再加上 callbackSecret,每次调用都会带一个 X-Hinto-Signature 请求头,也就是请求体的 HMAC-SHA256,你可以据此确认它确实来自 Hinto。投递失败最多重试 5 次。
运作方式
POST/api/external/v2/generate{ "videoId": "<video id>", "callbackUrl": "<your url>" }POST<your url>X-Hinto-Signature: <hmac>{ "event": "generation.completed", "jobId": "<job id>" }

四种作用域,按端点逐一校验

每个 v2 请求在执行前都会检查密钥的作用域。generate 启动一个任务,write 创建、编辑或移动内容,publish 发布或重新发布,read 覆盖其余一切。一个密钥只作用于它被签发时对应的那个项目。目前每个密钥都带着全部四种作用域,因为签发受限密钥还没做出来。

作用域它允许什么例如
read读取文章、文件夹、模板、视频、导出内容和任务状态GET /articlesGET /generate/{jobId}
write创建、移动、复制和恢复内容,以及上传视频POST /articles/emptyPATCH /folders/{id}/move
generate启动生成、重新生成和翻译,以及从链接导入视频POST /generatePOST /videos/import
publish发布和重新发布项目POST /publishPOST /publish/republish

在终端里跑它,或者交给一个智能体

CLI 包装的是同一个 API,智能体技能又包装了 CLI,所以人、脚本,以及像 Claude Code 或 Cursor 这样的智能体,用到的都是同一批命令。加上 --json 可以得到脚本能读的输出,加上 --wait 可以一直阻塞到任务完成。

$npm install -g @hintoai/cli

安装 CLI

$hinto articles list

列出项目里的每篇文章

$npx skills add hintoai/hinto-cli

安装智能体技能

Webhook:四个事件、一个网址、你自己的请求头

项目在发布、重新发布、取消发布和归档时会触发 webhook,并带上你为认证添加的任何请求头。每次调用会发送一个事件名称、项目和发布记录的 id、一个时间戳,以及项目的名称和网址 slug,也就是一条「发生了什么、去哪里找」的通知,而不是内容本身。

  • project.publish项目首次发布时
  • project.republish项目带着改动重新发布时
  • project.unpublish项目被取消发布时
  • project.archive项目被归档时
POSThttps://api.example.com/webhooksContent-Type: application/json
{
  "event": "project.republish",
  "projectId": "<project id>",
  "publicationId": "<publication id>",
  "timestamp": "2026-09-15T10:24:00.000Z",
  "data": {
    "projectName": "Acme Help Center",
    "urlSlug": "acme"
  }
}
以 POST 发送,并带上你的自定义请求头。Hinto 最多尝试 3 次,每次最长等待 30 秒,对 4xx 响应不重试。运作方式

连上你本来就在用的工具

一个 webhook、一个客服收件箱和一个建站工具,都可以从同一个项目读取内容。

给你自己系统用的 webhook

让 webhook 指向你自己的端点,在发布、重新发布、取消发布或归档发生时立刻做出响应。

Intercom Fin 用它来回答

把一个项目的内容同步进 Intercom,这样 Intercom 的客服智能体 Fin 就能基于 Hinto 生成的内容来回答。

Framer 把它导入你的网站

一个 Framer 插件可以把文章和文件夹导入 Framer CMS,用于在 Framer 里搭建并托管的网站。

关于 Hinto API、CLI 和智能体技能的常见问题

不需要。每个请求带一个 X-API-Key 请求头,对应在某个项目的设置里创建的密钥。

准备好更快搭建更好的
知识库了吗?

免费开始使用,几分钟内创建你的第一篇文章