做短视频二次剪辑、混剪、文案扒取、自媒体工具开发的开发者看过来！
一款短视频文案提取接口上线，支持抖音、快手、小红书、B 站分享链接，也支持 mp3 等音视频直链，可以直接提取完整口播文案 + 带毫秒级时间戳字幕，适合开发字幕工具、短视频解析机器人、文案采集工具、本地剪辑辅助程序。
✅ 接口亮点
- 多平台兼容：抖音 / 快手 / 小红书 / B 站，分享链接、音视频直链均可传入
- 输出带毫秒时间戳字幕，可直接用于剪辑、srt 字幕生成
- 混合鉴权：API Key / APP_ID+APP_SECRET 两种鉴权方式任选
- 上游响应透传，返回原生字幕结果，方便二次处理
- 错误码体系完善，鉴权、限流、余额、上游报错分类清晰，便于后端异常捕获
- 支持幂等请求，搭配
X-Idempotency-Key避免重复提交
📌 接入基础信息
- 接口地址：
https://api.xiaotuo.net/submit - 调试入口：
https://api.xiaotuo.net/api/v1/calls/invoke - 请求参数位置：Query 参数
- 鉴权方式：hybrid 混合鉴权
- 响应模式：auto_upstream，透传上游原始返回
请求参数
表格
| 参数 | 位置 | 说明 |
|---|---|---|
| url | query | 短视频分享链接 /mp3 音视频直链 |
curl 调用示例
curl -G 'https://api.xiaotuo.net/submit' \
--data-urlencode 'url=https://example.com/video-link'
注意：示例仅演示传参，需要自行加上平台要求的鉴权 header 或参数。
📋 鉴权说明
二选一：
- API Key 鉴权：缺失返回 100，密钥错误 / 未授权返回 101
- APP_ID + APP_SECRET 鉴权：缺失、不匹配、无效分别对应 130/131/132/133
额外校验：IP 白名单、黑名单拦截、幂等防重
⚠️ 计费 & 额度说明
元数据 price=0，实际计费模式以控制台为准，支持多种计费形态：
- 按次扣费、套餐包、积分、会员权限等
- 余额不足、套餐耗尽、会员未开通都会返回对应 403 错误码
🚦 限流规则
- 10005（429）：请求频率超限，响应头携带 Retry-After，建议做退避重试
- 10006（429）：全站免费日额度耗尽
- 114（429）：子 API Key 单独日限额打满
📋 核心错误码速查表
表格
| 错误码 | HTTP | 含义 |
|---|---|---|
| 100 | 401 | API Key 为空 |
| 101 | 401 | API Key 无效 / 未授权 |
| 106 | 403 | 余额不足 |
| 10005 | 429 | 请求频繁限流 |
| 10006 | 429 | 免费次数耗尽 |
| 20001 | 502 | 上游服务失败 |
| 20002 | 504 | 上游超时 |
🧩 适合开发场景
- 自媒体字幕提取工具、网页字幕解析站
- 机器人、脚本批量提取短视频文案
- 剪辑辅助工具，自动生成 srt 字幕文件
- 短视频内容分析、文案库采集系统
- 个人小工具、SaaS 原型开发
⚠️ 重要提醒
- 接口仅用于合规内容处理，禁止用于侵权爬取、违规批量采集；
- 上游服务存在不稳定、超时、解析失败情况，业务务必做好重试、降级、异常捕获；
- 实际返回结构由上游透传，开发前建议先调试看返回字段；
- 计费、单价、额度以平台控制台为准。
