ReadVideo
← 返回 ReadVideo

AI Agent · 接入指南

让你的 AI 助手使用 ReadVideo。

为助手创建独立的智能体身份，让它提交音视频、查询进度并获取文字稿。按下面三步完成接入。

创建或管理智能体

  1. 创建智能体并授权

    登录 ReadVideo，在「智能体」区域输入便于识别的名称，点击「创建智能体」。已有智能体如果显示尚未授权转写，可在该区域开通。

    前往智能体管理

  2. 在助手中配置凭据

    创建时保存仅显示一次的智能体密钥，在助手运行环境或密钥管理器中配置为：

    READVIDEO_AGENT_API_KEY

    这里使用智能体密钥，不是普通 API 密钥。密钥值请勿粘贴到聊天或代码中。

  3. 把接入说明交给助手

    完成凭据配置后，将下方说明复制给助手，再提供你有权处理的音频或视频。

    请读取 https://readvideo.ai/agent-skill，按其中的 aibot 通道接入 ReadVideo。运行环境已配置 READVIDEO_AGENT_API_KEY。先交换短期访问令牌，再处理我明确提供且有权处理的音视频；提交转写后查询任务状态，完成后返回带时间码的文字稿。如果任务失败，请返回原因。不要在聊天中显示密钥。

    助手需要能够读取接入文档并发起 HTTPS 请求；仅支持聊天的助手，无法只靠这段说明完成接入。

  4. 或者直接用命令行工具

    能执行命令的助手可以直接用 readvideo 命令行工具，不必手写接口调用。它是单个文件，只需要 Node 18 以上。它从环境变量读取 READVIDEO_AGENT_API_KEY，上传本地文件或提交链接，等待完成后把文字稿、字幕、章节和翻译写进一个文件夹。

    curl -fsSL https://readvideo.ai/agent/readvideo.js -o ~/.local/bin/readvideo
chmod +x ~/.local/bin/readvideo
readvideo transcribe talk.mp4 --translate --out ./talk

    运行 readvideo help 查看全部选项。每次转写和翻译都会使用你账户的积分。

开发者说明：令牌交换与 Agent Skill

智能体用长期密钥换取短期 access_token，再以 Bearer 令牌调用转写接口。智能体需要 asr:user 能力授权。

curl -s https://auth.xiaojins.com/oauth2/token \
  -d grant_type=urn:xjp:bot_api_key \
  -d client_id=readvideo \
  --data-urlencode api_key="$READVIDEO_AGENT_API_KEY"
打开机器可读的 Agent Skill

如需帮助，请联系 support@readvideo.ai。