接口文档
基础地址 https://jxapi.java68.cn · 稳定版前缀 /v1
1. 鉴权
所有 /v1 业务接口需带 Key,二选一:Authorization: Bearer vt_live_xxx或 X-API-Key: vt_live_xxx。
curl -X POST https://jxapi.java68.cn/v1/parse \
-H "Authorization: Bearer $VT_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://v.douyin.com/xxxx/","request_id":"demo-1"}'2. 统一响应
{ "code": 0, "msg": "ok", "request_id": "req_ab12", "cost": 1, "data": { ... } }cost 是本次计费次数,失败恒为 0。同一个 request_id 24 小时内只扣一次费。
3. 解析单条
POST /v1/parse
{ "url": "分享链接或整段文案", "author_sec_uid": "可选", "request_id": "建议传" }
→ { "code": 0, "cost": 1, "data": {
"type": "video", "title": "…", "author": "…",
"cover": "…", "video_url": "…", "images": [], "live_videos": [] } }视频直链下载必须带 Referer: https://www.douyin.com/,否则 CDN 403。
4. 主页批量
POST /v1/douyin/home
{ "sec_uid": "MS4wLjABAAAA…", "cursor": 0, "count": 20 }按成功返回条数计费,单页最低 10 条;仅包月专业及以上可用。
5. 错误码
| code | 含义 | 计费 |
|---|---|---|
| 0 | 成功 | 是 |
| 1001 | Key 无效/停用 | 否 |
| 1002 | 额度不足 | 否 |
| 1003 | 限流(看 Retry-After) | 否 |
| 2001 | 链接无法识别 | 否 |
| 2002 | 作品不存在或已删除 | 否 |
| 3001 | 上游暂时失败,可重试 | 否 |
| 5000 | 内部错误 | 否 |
6. 计费规则
- 按成功解析计费:0.02 元/次;图集、Live 实况图整条算 1 次
- 作品已删除、链接不支持、上游失败、限流拒绝 —— 一律不计费
- 包月套餐额度优先扣,用完自动转余额
- 同一
request_id重放不重复计费
OpenAPI 规范: openapi.yaml(可直接导入 Postman / Apifox / Swagger UI)
需要更大额度或更高并发?查看套餐