Question 1

销豹 AI API 是什么？

Accepted Answer

销豹 AI API（xiaoapis.com）是中科云创提供的企业级 AI 能力开放平台，通过 HTTP API 提供视频解析、文案提取、TTS、声音克隆、数字人、智能剪辑等内容生产能力。

Question 2

如何获取销豹 API Key？

Accepted Answer

注册并登录控制台后，在「API Key 管理」创建或复制密钥，请求时以 URL 参数 `key` 或 JSON 字段 `key` 携带（以各接口文档为准）。

Question 3

API Key 应该放在 URL 还是 Body？

Accepted Answer

多数接口支持 URL 查询参数 `?key=`；使用 POST + JSON 时，部分接口要求把 `key` 写在 JSON Body 内。以当前接口 HTML / Markdown 文档中的鉴权说明为准。

Question 4

销豹 API 有没有官方 SDK？

Accepted Answer

当前以 HTTP REST 接口为主，开发者可用任意语言发起请求；站点提供 HTML 文档与 `/model/*.md` 供人读与 Agent 读。

Question 5

异步任务怎么查询结果？

Accepted Answer

创建接口返回 `task_id` 后，用对应业务的查询接口（或智能剪辑的 `action=query` / `task_query`）传入 `task_id` 轮询；也可在 create 时填写 `callback_url` / `notify` 接收完成回调。

Question 6

AI Agent 应该读哪份文档？

Accepted Answer

优先读取 `/model/{能力}.md`（机器可读 Markdown）与 `/llms.txt` 索引；需要讲解与选型时再读 `/guides/` 与 `/doc/{id}`。

Question 7

销豹 API 怎么计费？

Accepted Answer

不同接口计费维度不同：有的按次，有的按输入秒/分辨率（如智能剪辑），有的按时长。以各接口文档「计费说明」和控制台余额/账单为准，本文不虚构单价。

Question 8

调用失败提示余额不足怎么办？

Accepted Answer

到控制台查看余额与账单，按需充值或开通套餐后再创建任务。异步任务若在创建阶段余额不足会直接拒绝，一般不会产生半成品扣费。

Question 9

数字人 API 怎么调用？

Accepted Answer

使用 API Key 调用数字人创建接口，提交公网可访问的人物视频与驱动音频等必填字段，拿到 `task_id` 后轮询查询或等待回调，成片地址在成功结果中返回。

Question 10

高清数字人和超凡数字人有什么区别？

Accepted Answer

高清数字人侧重「人物视频 + 驱动音频」合成口播出镜；超凡数字人侧重「照片 + 驱动音频」生成说话/口播类形象视频。按你手头素材选对应接口。

Question 11

声音克隆之后怎么接 TTS 和数字人？

Accepted Answer

先调用声音克隆拿到音色相关标识，再在语音合成（TTS）中按文档字段使用该音色生成音频，最后把音频作为数字人驱动音频提交合成。

Question 12

不做声音克隆可以直接 TTS 吗？

Accepted Answer

可以。先调[公共音色列表](/doc/58)拿到 `voice_id`，再在语音合成里设 `voice_type=public` 即可，无需先克隆。

Question 13

系统音色 voice_id 从哪里拿？

Accepted Answer

调用[公共音色列表](/doc/58)（`/api/aihuman/public_voices`）获取。返回的 `list[].voice_id` 直接传给 TTS，并设置 `voice_type=public`。

Question 14

真人口播、口播混剪、新闻混剪怎么选？

Accepted Answer

有真人/数字人成片视频要套模板包装 → 真人口播；以音频/文案口播配素材画面 → 口播混剪；新闻资讯类标题 + 多段素材混剪 → 新闻混剪。

Question 15

智能剪辑接口为什么报「请提供 videoUrl」？

Accepted Answer

多半是走了默认的 `action=create`（创建）却没传 `videoUrl`/`styleId`。若 Body 只有 `task_id`，应使用 `action=query` 查询异步任务，或调用任务查询接口。

Question 16

智能剪辑按什么计费？

Accepted Answer

通常按输出分辨率单价 × 输入媒体探测秒数（向上取整）计费，例如真人口播对 `videoUrl` 探测时长。无法解析有效时长时请求会被拒绝。

Question 17

styleId 模板 ID 从哪里拿？

Accepted Answer

调用智能剪辑「模板列表」接口，按场景（如真人口播、口播混剪、新闻混剪）拉取列表，使用返回的模板 `id` 作为 create 时的 `styleId`。需要图层细节时再调模板详情。

Question 18

数字人成片后怎么再包装成短视频？

Accepted Answer

把数字人输出的视频 URL 作为真人口播（或适用模式）的 `videoUrl`，搭配模板 `styleId`、字幕/包装规则提交智能剪辑 create，即可生成带包装的可发布成片。

Question 19

视频解析 API 能做什么？

Accepted Answer

通过分享链接等方式解析视频的基本信息（如标题、封面、直链、作者等，以当前文档字段为准），用于内容分析、素材入库与二次创作上游。

Question 20

视频解析支持哪些平台？

Accepted Answer

全平台视频解析支持范围以 [/doc/43](/doc/43) 列出的平台为准。若只要解析微信视频号，可直接用专用接口 [/doc/57](/doc/57)。请用真实分享链接联调验证。

Question 21

视频解析和短视频文案提取有什么区别？

Accepted Answer

视频解析侧重从分享链接拿到视频元数据与资源信息；短视频文案提取侧重从视频中得到文案/字幕类文本结果。两者可串联：先解析再提取文案。

Question 22

微信视频号视频解析 API 能做什么？

Accepted Answer

专门解析微信视频号分享链接（或带链接的口令），同步返回标题、封面、视频直链、作者与互动数据，用于内容分析、爆款拆解与素材入库。

Question 23

微信视频号解析和全平台视频解析怎么选？

Accepted Answer

明确只要视频号时用专用接口 [/doc/57](/doc/57)（成功常见 5 点）；需要覆盖多平台统一入口时用全平台解析 [/doc/43](/doc/43)。两者都可同步返回标题/封面/媒体地址，字段结构略有差异。

Question 24

什么时候用语音转文字（ASR）？

Accepted Answer

需要对口播音频或视频音轨做转写、改字幕或给智能剪辑提供 `subtitle` 时，使用 ASR / 语音转文字类接口。结果可按文档格式回填到剪辑参数。

Question 25

销豹有哪些图像生成相关 API？

Accepted Answer

平台提供通用 AI 图像生成（/doc/13）、GPT Image 能力，以及面向短视频的 IP 视频封面（/doc/55：口播文案自动提炼标题 + 竖版人物封面）。统一 API Key，具体模型参数与计费见各文档页。

Question 26

什么是 IP 视频封面 API？

Accepted Answer

IP 视频封面 API 根据口播文案自动提炼主/副标题，并可结合人物参考图生成竖版 9:16 视频号/抖音封面海报，一套请求完成「标题+封面」。

Question 27

IP 视频封面 API 怎么调用？

Accepted Answer

POST `https://xiaoapis.com/api/image/ip_cover`，JSON 携带 `key`，以及 `script`（口播）和/或 `title`、`person_url`。提交后立即返回 `task_id`。可用 `notify` 回调，或调用[任务查询](/doc/56)按 `task_id` 轮询。

Question 28

IP 视频封面如何用 task_id 查询？

Accepted Answer

创建返回 `task_id` 后，请求同一接口：`GET /api/image/ip_cover?action=query&task_id=...&key=...`（或只传 `task_id`）。`status`：0 处理中，1 成功，2 失败。查询不扣费。

Question 29

IP 视频封面怎么计费？会不会再扣 Terra 或图像费用？

Accepted Answer

本接口统一按次扣点（默认 30 点，以控制台 `consume` 为准）。内部标题提炼与出图直连上游，不对用户二次计费，不会记入 Terra（/doc/54）或 AI 图像（/doc/13）额度。失败不扣费。

Question 30

文生视频 API 怎么选？

Accepted Answer

平台上线多款文生视频/视频生成接口，能力、时长与计费不同。按产品文档中的模型说明与示例选择，并以控制台展示的接口为准。

Question 31

视频翻译 API 适合什么场景？

Accepted Answer

需要对成片或素材做多语种口播/字幕向翻译与再合成时，使用平台已上线的视频翻译相关接口。输入输出字段与语种支持以对应文档为准。

Question 32

提交的视频/音频 URL 有什么要求？

Accepted Answer

一般需要公网可访问的 http/https 地址，格式与大小、时长上限以各接口文档为准。智能剪辑还会探测媒体时长用于计费，无法访问或无法解析时长会导致创建失败。

Question 33

callback_url 回调怎么写？

Accepted Answer

提供一个公网可访问的 HTTPS（或文档允许的）地址，任务成功或失败时平台会 POST 通知；字段结构以对应接口回调说明为准。也可与轮询 `task_id` 并用。

Question 34

文档示例里的域名应该填什么？

Accepted Answer

对外文档与示例统一使用销豹平台域名或「你的可访问存储」类占位，不要把上游厂商域名写进公开文案。业务素材请换成你自己的可公网访问 URL。

销豹 AI API 精选问答

平台

计费

数字人

智能剪辑

视频解析

内容生成

素材与合规