返回调试台

解析抖音分享链接获取文案 API

GET /api/plugins/douyin/dy_video_to_text

接口描述

提供抖音视频链接,自动解析视频详情并提取音频转换为文字。支持获取视频标题、作者、发布时间、点赞数等元数据,以及视频音频的逐句文字记录。

适用场景: 内容创作者素材提取、视频内容分析、竞品监控等。

权限点: douyin.video.read

请求参数

参数名 类型 必选 描述
url string 抖音视频分享链接,例如:https://v.douyin.com/KjeQnQ1bMWM/
api_key string 用户 API Key,用于鉴权和计费
use_own_key boolean 是否使用用户自己的阿里云 API Key。默认为 false

计费说明

本接口采用组合计费模式:基础服务费 + 时长费

  • 基础服务费:每次调用固定扣除 1 次用量(用于视频解析)。
  • 时长费:根据视频时长计算,费率为 0.15 次用量/秒
    • 计算公式:总费用 = 基础服务费(1) + ⌈视频秒数 × 0.15⌉
    • 示例:一个 60 秒的视频,总费用 = 1 + ⌈60 × 0.15⌉ = 10 次用量。
  • 优惠政策
    • 如果在请求中设置 use_own_key=true 且用户已配置阿里云 API Key,则仅收取 1 次用量的基础服务费,免收时长费。
    • 如果音频提取失败(is_audio_success: false),仅收取 1 次用量的基础服务费。

👉 用量管理:您可以前往 API 插件中心 查看剩余用量及进行充值。

响应参数

参数名 类型 描述
code integer 状态码,0 表示成功
success boolean 请求是否成功
msg string 状态描述及消耗信息
data object 响应数据对象
data.desc string 视频文案/标题
data.nickname string 作者昵称
data.unique_id string 作者抖音号
data.signature string 作者签名
data.author_id string 作者内部 ID
data.owner_nickname string 作者昵称(同 nickname)
data.total_favorited number 作者获赞总量
data.enterprise_verify_reason string 企业认证信息
data.create_time integer 视频发布时间(Unix 时间戳)
data.duration integer 视频时长(毫秒)
data.aweme_id string 视频唯一 ID
data.caption string 视频标题/文案(同 desc)
data.share_url string 视频分享链接
data.music_title string 背景音乐标题
data.digg_count integer 点赞数量
data.comment_count integer 评论数量
data.collect_count integer 收藏数量
data.share_count integer 分享数量
data.video_url string 无水印视频播放链接
data.play_url string 背景音乐/音频播放链接
data.cover string 视频封面图链接
data.audio_text string 提取的音频文字内容
data.is_audio_success boolean 音频提取是否成功

示例

请求示例

curl -X GET "https://cyanlis.cn/api/plugins/douyin/dy_video_to_text?url=https://v.douyin.com/KjeQnQ1bMWM/&api_key=YOUR_API_KEY"

响应示例

Loading...

错误码

错误码 描述 解决方案
401 Unauthorized API Key 无效或过期,请检查 Key 是否正确
400 Bad Request 请求参数错误,如 URL 格式不正确
403 Forbidden 余额不足或权限受限
500 Internal Server Error 服务器内部错误,请联系技术支持