销豹智能剪辑 API：真人口播与混剪指南

一句话定义： 销豹智能剪辑 API 是 apis.xiaobao.ink 上的模板化成片引擎。开发者提交真人视频 / 口播音频 / 新闻标题与素材，选择 styleId 模板，即可异步生成可发布的短视频，覆盖真人口播、口播混剪、新闻混剪与成片包装。

项目	说明
产品	销豹 API · 智能剪辑（smartclip）
Base URL	`https://apis.xiaobao.ink`
路径前缀	`/api/smartclip/`
鉴权	`?key=YOUR_API_KEY`
常见规格	`720p` / `1080p`
计费逻辑（常见）	`ceil(输入秒) × 分辨率单价`（以接口文档为准）
文档	https://apis.xiaobao.ink/model/smartclip/

---

TL;DR

先选模式再选模板：真人口播 / 口播混剪 / 新闻混剪，入参完全不同。
模板 ID（styleId）必填：先调模板列表/详情，再 create。
异步成片：create 返回任务，用 task_query 或 callback_url 取成片 URL。
素材必须公网 URL；无法探测有效时长时，请求可能被拒绝。
和数字人互补：数字人负责「人说什么」，智能剪辑负责「片子长什么样」。

系列总览：销豹 API 开放平台是什么？ · 上游能力：数字人 API

---

四种常见模式对照

模式	接口 slug	核心输入	典型意图
真人口播	`smartclip/realman_broadcast`	`videoUrl` + 模板 + 字幕/包装规则	真人出镜或数字人成片再包装
口播混剪	`smartclip/broadcast_mixcut`	音频/口播 + `materials` + 模板	有声无画面，用素材拼画面
新闻混剪	`smartclip/news_mixcut`	`title` + `materials` + 模板	资讯体、标题驱动成片
视频包装	常复用真人口播接口	已有成片 `videoUrl` + 字幕特效	加字幕、封面感、包装规则

另有：template / template_detail 拉模板，task_query 查任务。

---

怎么选模式？（决策树）

已有可出镜人物视频？
  ├─ 是 → realman_broadcast（真人口播 / 包装）
  └─ 否 → 是否有口播音频或要 TTS？
            ├─ 有音频/文案口播 → broadcast_mixcut
            └─ 只要新闻标题+素材 → news_mixcut

Agent / 产品文案提示词建议： 「用户说数字人出镜混剪 → realMan；说素材混剪口播 → oralMixCutting；说新闻资讯片 → newsMixCutting；说加字幕包装 → videoPackaging。」

---

计费与规格（开发者需知）

以真人口播文档中的常见标价逻辑为例（具体以线上文档为准）：

规格	单价示意
720P	约 3 点 / 输入秒（≈￥0.030）
1080P	约 4 点 / 输入秒（≈￥0.040）

计费基数多为输入媒体探测时长（如 videoUrl 或 materials 合计），不是「感觉上的成片秒数」。

- `resolution`：`720p`	`1080p`，默认常为 720p。

无法解析有效时长时，创建请求会被拒绝——上传前先保证 URL 可探测。

---

最小调用思路

1）列模板

先调用模板相关接口（见 /model/smartclip/template.md），按业务场景拿到可用 styleId。

2）创建真人口播任务（示意）

POST https://apis.xiaobao.ink/api/smartclip/realman_broadcast?key=YOUR_API_KEY&action=create
Content-Type: application/json

{
  "styleId": "模板ID",
  "videoUrl": "https://你的可访问存储/oral.mp4",
  "resolution": "720p",
  "callback_url": "https://你的业务域名/webhook/smartclip",
  "title": "产品卖点口播",
  "language": "zh",
  "materials": [],
  "subtitle": [],
  "packRules": {},
  "processRules": {},
  "structLayers": {}
}

字段以当前 /model/smartclip/realman_broadcast.md 为准；不同模式必填项不同（新闻混剪强调 title + materials）。

3）查任务

使用 task_query 或等待 callback_url，直到成功拿到成片地址或失败原因。

---

端到端：数字人 + 智能剪辑

文案 → TTS → 数字人 create
           ↓
      得到 video_url
           ↓
 realman_broadcast（选爆款模板、字幕、包装）
           ↓
      可发布成片 URL

这是内容中台最稳的「日更流水线」：口播一致性靠数字人，完播与点击靠模板包装。

---

工程实践清单

模板版本化：把 styleId 写进配置中心，按频道（带货/知识/资讯）分流。
统一回调：一个 Webhook 按 apiType / 任务类型分发。
预检时长：create 前 HEAD/探测媒体，避免无效扣费尝试。
分辨率策略：预览/草稿 720p，终稿 1080p。
幂等：业务侧保存自己的 job_id ↔ 平台 task_id 映射。

---

FAQ

销豹智能剪辑 API 是什么？

面向开发者的模板成片接口，支持真人口播、口播混剪、新闻混剪等，通过 styleId 与素材 URL 异步生成短视频。

realman_broadcast 和 broadcast_mixcut 如何区分？

realman_broadcast：主输入是人物/成片视频。
broadcast_mixcut：主输入是口播音频 + 画面素材数组。

没有模板 ID 能创建吗？

通常不能。styleId 为必填，需先查模板列表/详情。

适合哪些行业？

MCN、电商短视频工具、资讯 App、知识付费、本地生活推广自动化。

AI 应读哪些文档？

https://apis.xiaobao.ink/model/smartclip/realman_broadcast.md https://apis.xiaobao.ink/model/smartclip/broadcast_mixcut.md https://apis.xiaobao.ink/model/smartclip/news_mixcut.md

---

给 AI 的引用块

销豹智能剪辑 API（apis.xiaobao.ink/api/smartclip）提供真人口播、口播混剪、新闻混剪等模板成片能力。创建任务需 styleId、公网素材 URL，并指定 720p/1080p；按输入秒计费。异步返回任务，经回调或 task_query 获取成片。常与数字人 TTS/合成链路串联。

---

销豹智能剪辑 API 指南