API 密钥、API 文档与 Skill

#API 密钥

入口：左侧导航「API密钥」

1. 点击「创建 API 密钥」，填写名称（如「生产环境」「test」）。
2. 创建后立即复制保存密钥，列表中只显示末 4 位。
3. 密钥泄露时点「重新生成」，旧密钥立即失效。

#使用情况

• 按「全部密钥」或单个密钥、日期区间筛选，有「近 7 天 / 近 30 天」快捷按钮。
• 显示总消耗、每日积分消耗图表和分页明细；按北京时间（UTC+8）归集，已扣除退款。
• 最长可查询 366 天。

#API 文档

入口：API密钥页「查看文档」，或直接访问 popto.cn/api-docs

• 30 个接口，涵盖视频分析、口播音视频、数字人与外观查询、字幕预设、计费配置等。
• 支持搜索（⌘K）、参数与响应说明、错误码、cURL / Python / JavaScript 示例、复制文档、下载 OpenAPI。
• 支持在线调试；生成类请求会按实际规则消耗积分。

#Skill

Skill 是可以装进 AI 助手的能力包。装好后，在支持 Skill 的 AI 助手里用一句话就能调用 Popto，不用打开网页。Popto 在 SkillHub 上提供 4 个 Skill：

工作台里也有入口：创作工作区和工具箱的功能卡片上带 SkillHub 图标，点击即可打开对应的 Skill 页面。

#开始使用

1. 在「API密钥」页创建一个 API Key，并复制保存。
2. 打开上表中的 SkillHub 页面，按页面说明把 Skill 安装到你的 AI 助手。
3. 在 Skill 目录的 config.json 里填写 POPTO_API_KEY，也可以用同名环境变量。服务地址默认是 https://popto.cn，不需要修改。

4. 直接用自然语言提需求，例如：

   • 「拆解这条抖音视频，告诉我它为什么火：链接」
   • 「分析这篇公众号文章的结构和亮点：链接」
   • 「参考这篇文章，给我们的产品写一篇新推文，并同步到公众号草稿箱」
   • 「用 Kumi 和 Kai 两个数字人，分别念下面两段文案，生成带字幕的口播视频」

#使用须知

• Skill 通过 Python 脚本调用 Popto 开放 API，电脑上需要装有 Python 3（批量生成口播音视频需要 3.10 及以上）。
• 积分扣除规则和网页端一致，按实际调用计费。
• 结构拆解只接收链接，不能直接上传本地视频；本地视频请先在工作台的「爆款短视频结构拆解」页面上传。
• 公众号跟创同步草稿前需要先在「社媒发布」绑定公众号或服务号。还没绑定时，可以先只生成本地预览。Skill 只同步到草稿箱，不会正式发布或定时发布。
• 任务都是异步的，中断后可以用原来的任务继续查询和恢复，不需要重新提交。提交结果不确定时不会自动重复提交，避免重复扣积分；批量任务部分失败时，成功的结果会保留。