开发者接口文档

这一页是给「想在自己小程序 / 软件里接入出词能力」的开发者看的。普通用户出词请回首页用「在线工具」，无需阅读本页。

💡 一句话：这是给你自己的小程序 / 软件用的"代加工服务"。你把剧本发过来，本站服务器替你调 AI 写好分镜词、做完体检，再把成品 JSON 寄回去。全程不需要你有任何大模型账号。

整个流程就这一张图

对照着看，四个接口其实就是四句人话：

接口（技术名）	人话
`POST /api/storyboard`	"帮我把这段剧本写成一条条镜头卡"（主接口，最常用）
`POST /api/asset`	"帮我把这些角色/场景做成画图用的资产卡"
`POST /api/validate`	"帮我检查这份分镜合不合格"（只检查不写词，秒回、免费）
`GET /api/ping`	"店里还有人吗？"（探活，回一声"在"）

怎么用？就两步

第 1 步（只有小程序需要）：微信公众平台 → 开发 → 开发设置 → 服务器域名 → 「request 合法域名」添加 https://www.fenjingzhushou.com。用网页或脚本调用的话，这步直接跳过。

第 2 步：把剧本寄过去。小程序里照抄下面这段，改一下剧本文字就能用：

▸ 点开查看小程序示例代码（不需要写代码就不用点）

wx.request({
  url: 'https://www.fenjingzhushou.com/api/storyboard',
  method: 'POST',
  timeout: 300000,                       // 长剧本要等 1-3 分钟
  data: { text: '在这里粘贴剧本原文', mode: 'ipcut' },
  success(res) {
    if (!res.data.ok) { console.error(res.data.error); return }
    console.log('分镜JSON：', res.data.data)       // ← 成品在这里
    console.log('校验报告：', res.data.validation) // ← 体检结果在这里
  }
})

寄回来的是什么？

包裹里有什么	是啥
`ok`	成功还是失败（false 时看 error，是中文说明）
`data`	成品本体：每个镜头的画面词、负面词等，直接喂给 ComfyUI 出片器就能渲染
`validation`	体检单：pass 是合格的，warn 是建议改的，fail 是必须改的

⚠️ 长剧本出词 1-3 分钟属正常（AI 要逐镜写词），超时记得设 300 秒；更长的剧本拆成几段分别寄。