做短视频二次剪辑、混剪、文案扒取、自媒体工具开发的开发者看过来！
一款短视频文案提取接口上线，支持抖音、快手、小红书、B 站分享链接，也支持 mp3 等音视频直链，可以直接提取完整口播文案 + 带毫秒级时间戳字幕，适合开发字幕工具、短视频解析机器人、文案采集工具、本地剪辑辅助程序。

✅ 接口亮点

1. 多平台兼容：抖音 / 快手 / 小红书 / B 站，分享链接、音视频直链均可传入
2. 输出带毫秒时间戳字幕，可直接用于剪辑、srt 字幕生成
3. 混合鉴权：API Key / APP_ID+APP_SECRET 两种鉴权方式任选
4. 上游响应透传，返回原生字幕结果，方便二次处理
5. 错误码体系完善，鉴权、限流、余额、上游报错分类清晰，便于后端异常捕获
6. 支持幂等请求，搭配 X-Idempotency-Key 避免重复提交

📌 接入基础信息

• 接口地址：https://api.xiaotuo.net/submit
• 调试入口：https://api.xiaotuo.net/api/v1/calls/invoke
• 请求参数位置：Query 参数
• 鉴权方式：hybrid 混合鉴权
• 响应模式：auto_upstream，透传上游原始返回

请求参数

表格

curl 调用示例

curl -G 'https://api.xiaotuo.net/submit' \
  --data-urlencode 'url=https://example.com/video-link'

注意：示例仅演示传参，需要自行加上平台要求的鉴权 header 或参数。

📋 鉴权说明

二选一：

1. API Key 鉴权：缺失返回 100，密钥错误 / 未授权返回 101
2. APP_ID + APP_SECRET 鉴权：缺失、不匹配、无效分别对应 130/131/132/133
   额外校验：IP 白名单、黑名单拦截、幂等防重

⚠️ 计费 & 额度说明

元数据 price=0，实际计费模式以控制台为准，支持多种计费形态：

• 按次扣费、套餐包、积分、会员权限等
• 余额不足、套餐耗尽、会员未开通都会返回对应 403 错误码

🚦 限流规则

• 10005（429）：请求频率超限，响应头携带 Retry-After，建议做退避重试
• 10006（429）：全站免费日额度耗尽
• 114（429）：子 API Key 单独日限额打满

📋 核心错误码速查表

表格

🧩 适合开发场景

• 自媒体字幕提取工具、网页字幕解析站
• 机器人、脚本批量提取短视频文案
• 剪辑辅助工具，自动生成 srt 字幕文件
• 短视频内容分析、文案库采集系统
• 个人小工具、SaaS 原型开发

⚠️ 重要提醒

1. 接口仅用于合规内容处理，禁止用于侵权爬取、违规批量采集；
2. 上游服务存在不稳定、超时、解析失败情况，业务务必做好重试、降级、异常捕获；
3. 实际返回结构由上游透传，开发前建议先调试看返回字段；
4. 计费、单价、额度以平台控制台为准。