API 接入指南

通过我们的 RESTful API，您可以将视频解析能力无缝集成到您的应用或工作流中。支持抖音和 TikTok 平台的视频元数据提取和无水印视频下载。

需要 API 密钥

使用 API 需要先登录并生成您的专属 API 密钥。密钥用于身份验证和使用统计。

快速开始

1. 获取 API 密钥

登录后访问 API 密钥管理页面，点击"生成新密钥"按钮创建您的专属密钥。

2. 发起 API 请求

在请求头中添加 Authorization 字段，值为 "Bearer YOUR_API_KEY"。

3. 处理响应数据

API 返回 JSON 格式的数据，包含视频的完整元数据和下载链接。

API 接口

解析视频

POST

/api/trpc/video.parse

请求参数

参数名	类型	必填	说明
url	string	是	抖音或 TikTok 视频链接
shouldDownload	boolean	否	是否下载视频到云存储（默认 false）

响应字段

字段名	类型	说明
success	boolean	请求是否成功
data	object	视频数据对象
data.id	string	视频 ID
data.title	string	视频标题
data.author	object	作者信息
data.stats	object	统计数据（播放、点赞、评论、分享）
data.video	object	视频信息（下载链接、时长、分辨率）

代码示例

cURL 请求示例

curl -X POST https://your-domain.com/api/trpc/video.parse \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "url": "https://www.tiktok.com/@username/video/1234567890",
    "shouldDownload": false
  }'

响应示例

{
  "success": true,
  "data": {
    "id": "1234567890",
    "title": "视频标题",
    "description": "视频描述",
    "cover": "https://example.com/cover.jpg",
    "author": {
      "id": "user123",
      "username": "username",
      "nickname": "用户昵称",
      "avatar": "https://example.com/avatar.jpg"
    },
    "stats": {
      "playCount": 100000,
      "likeCount": 5000,
      "commentCount": 200,
      "shareCount": 150
    },
    "video": {
      "downloadUrl": "https://storage.example.com/video.mp4",
      "duration": 15,
      "width": 1080,
      "height": 1920
    },
    "createdAt": "2026-01-25T12:00:00Z"
  }
}

错误码说明

错误码	说明	解决方案
401	未授权	检查 API 密钥是否正确
400	请求参数错误	检查视频链接格式是否正确
404	视频不存在	确认视频链接有效且未被删除
429	请求过于频繁	降低请求频率或联系我们提升限额
500	服务器错误	稍后重试或联系技术支持

使用限制

请求频率限制

每个 API 密钥默认限制为每分钟 60 次请求。如需提升限额，请联系我们。

数据保留期限

云存储中的视频文件保留 7 天，过期后将自动删除。建议及时下载到本地。

使用规范

请遵守相关平台的服务条款和版权规定，不得用于非法用途或侵犯他人权益。

技术支持

如果您在使用 API 过程中遇到问题，或有任何建议和反馈，欢迎通过以下方式联系我们：

• 查看解析历史和 API 调用日志

• 访问 API 密钥管理页面查看使用统计

• 通过平台内的反馈功能提交问题