面向开发者和自动化流程
短视频文案提取 API
如果你需要把短视频转文字接入自己的工具、后台或 Agent 工作流，可以使用 Videosays API。API 支持提交公开链接、查询任务状态和获取转写结果。
REST API 支持创建任务、查询状态和获取 text / SRT / VTT · 仅支持公开可访问的链接
你会得到什么
把短视频转文字接进自己的系统
API 适合批量处理、后台任务、Agent Runtime 和内容分析系统。你可以提交公开视频链接，保存任务 ID，并在任务完成后读取纯文本、时间轴和字幕格式。
提交公开视频链接并创建转写任务。
按任务 ID 查询 processing、completed 或 failed 状态。
任务完成后读取 text、timeline、SRT 或 VTT。
API 接入的最小闭环
创建 API Key
在控制台生成 API Key，并通过请求头调用 Videosays API。
提交链接并保存任务 ID
后端提交公开短视频链接，把返回的任务 ID 写入自己的数据库或队列。
轮询结果并入库
任务完成后保存转写文本、时间轴、视频平台和来源链接，继续做摘要、分类或检索。
短视频文案提取 API适合哪些场景
批量处理短视频链接并写入数据库
接入内部运营工具和素材系统
给 Agent 工作流提供视频文字化能力
为内容分析、摘要和分类提供原始文本
API 适合什么团队
当你不只是偶尔提取一条视频，而是需要持续处理链接、维护任务状态、保存历史结果时，API 会比手动网页操作更稳定。它适合内容工具、数据分析、运营后台和自动化 Agent。
基本接入方式
开发者可以在控制台获取 API Key，然后调用转写接口提交公开短视频分享链接。任务创建后，通过查询接口获取状态和结果。详细参数、错误码和示例可以查看 API 文档。
和 Skill / CLI 的关系
Skill 和 CLI 都可以看作 API 的上层封装。个人使用可以从 Skill 或 CLI 开始，团队系统集成则建议直接使用 REST API。
常见问题
API 支持查询余额吗？
支持。文档中提供余额查询和历史任务查询接口。
API 如何认证？
使用控制台生成的 API Key，通过请求头传入即可。
有没有调用示例？
有。你可以在 /docs 查看 cURL、CLI 和 REST API 示例。