返回调试台

小红书视频转文字 API

GET /api/plugins/xiaohongshu/video_to_text

接口描述

获取小红书笔记详情，并自动检测是否包含视频。如果包含视频，将提取音频内容并转换为文字。支持长视频识别。

请求参数

参数名 类型 必选 描述
url string 是 小红书笔记链接（支持短链和长链）
cookie string 否 小红书 Cookie（提供登录态 Cookie 可获取更多数据）
apiKey string 是 用户 API Key
use_own_key boolean 否 是否使用自己的阿里云 API Key（默认为 false）。
如果开启，需先在用户中心配置阿里云 Key。

计费说明

本接口采用动态计费模式：

  • 基础费用：每次调用固定扣除 1 点。
  • 时长费用：如果成功转换视频文字，额外收取 0.15 点/秒（向上取整）。
  • 自有 Key 优惠：如果参数 use_own_key=true，则仅收取基础费用 1 点。

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

响应参数

参数名 类型 描述
code number 状态码，0 表示成功
success boolean 请求是否成功
msg string 提示信息（包含本次消耗及剩余用量）
data object 笔记及转写详情
  └─ note_id string 笔记唯一标识 ID
  └─ title string 笔记标题
  └─ desc string 笔记描述/文案
  └─ type string 笔记类型（video: 视频, normal: 图文）
  └─ audio_text string 视频转文字内容（核心字段）
  └─ is_audio_success boolean 转写是否成功
  └─ user object 作者信息
    └─ nickname string 作者昵称
    └─ avatar string 作者头像链接
  └─ stats object 互动统计数据
    └─ liked_count number 点赞数
    └─ collected_count number 收藏数
    └─ comment_count number 评论数
    └─ share_count number 分享数
  └─ images array 图片列表
  └─ video object 视频信息
    └─ url string 无水印视频链接
    └─ cover string 视频封面图链接
  └─ original_url string 原始笔记链接

示例

请求示例

curl -X GET "https://cyanlis.cn/api/plugins/xiaohongshu/video_to_text?url=https://www.xiaohongshu.com/explore/65bc6c1400000000080219ef&apiKey=YOUR_API_KEY"

响应示例

Loading...

错误码

错误码 描述 解决方案
401 Unauthorized API Key 无效或过期，请检查 Key 是否正确
400 Bad Request 请求参数错误（如 URL 为空）
403 Forbidden 余额不足或权限受限
500 Internal Server Error 服务器内部错误或转写失败