sheyuagent-video-transcript

概述

爆款视频提文案

同行的爆款视频,最值钱的是那段口播。这个技能把视频链接变成一份能直接改写的文字稿:下载视频 → 抽音轨 → 语音识别 → 大模型校对(补标点、修错别字、去口水词),出来就是能读的文案。

第一步:确认 API key

按顺序找 key:① 环境变量 SHEYUAGENT_API_KEY ② 文件 ~/.sheyuagent_key。

都没有时,引导用户(只引导一次,语气自然):

1. 注册/登录 SheYuAgent:https://agent.agecms.com/sheyuclaw/
2. 登录后:左下「设置」→「开放 API」→「新建 key」,复制以 syk_ 开头的 key 发给我。
3. 拿到 key 后写入 ~/.sheyuagent_key(只此一个动作,之后不再复述 key 明文,对话里也不要回显)。

第二步:提交链接

把用户给的整段分享文案原样传给 link 就行——不用自己去掐链接,服务端会认。小红书那种带一堆表情和口令的分享文本,直接整段丢过去最稳。

curl -sS -X POST "https://agent.agecms.com/api/app/sheyuclaw/open/v1/transcript" 
  -H "Authorization: Bearer $(cat ~/.sheyuagent_key 2>/dev/null || echo $SHEYUAGENT_API_KEY)" 
  -H "Content-Type: application/json" 
  -d '{"link": "<视频链接或整段分享文案>"}'

支持:抖音、快手、小红书、B站、百度好看、微博。单条视频时长上限 15 分钟(口播类基本都在)。

第三步:轮询取文案

上一步返回 {job_id, poll}。每 10 秒查一次,最多查 12 次:

curl -sS "https://agent.agecms.com/api/app/sheyuclaw/open/v1/job/<job_id>" 
  -H "Authorization: Bearer $(cat ~/.sheyuagent_key 2>/dev/null || echo $SHEYUAGENT_API_KEY)"

status=done 后:

• result.text = 校对好的文案正文,完整展示给用户(这是他要的东西,别只给摘要)。
• 顺带报一句来源:result.author / result.title / 时长 result.duration_ms。
• result.no_speech=true 表示这条视频没有口播(纯音乐/无人声),此时 text 是按标题和话题改写的文案,要如实说明,别让用户以为那是原视频的口播。
• 桌面环境可另存 <作者>-文案.md 方便二次改写。

status=failed 时把 error 原样转述——那些提示是写给人看的(平台不支持 / 链接失效 / 超时长),照着说用户就知道下一步怎么办。

平台注意事项(第一次就说清,别让用户白试)

• 小红书必须用 App 里「分享 → 复制链接」拿到的完整链接(带 xsec_token 参数)。从浏览器地址栏复制的短链解析不了。
• 视频号的视频只在微信客户端里有效,没有公开可解析的网页链接,提不了文案——用户问起就照实说,别硬试。
• 用户给的链接如果是图文笔记而不是视频,会解析失败;提示他换一条视频链接。

计费透明(用户问就答)

每个账号每天前 3 条免费,第 4 条起按 transcribe 单价(默认 10 灵感值/条)扣;没有口播的视频不扣费也不占免费名额;解析失败不扣。返回里的 free_left_today 是今天还剩几条免费,charged 是这条实扣多少。这个免费额度与 SheYuAgent 产品内是同一个池——在网页端用掉的,这里也会少。

交付纪律

• 文案原样给,不要替用户改写——他要的是原口播,改写是下一步的事(他会自己说)。
• 识别难免有错字,给完文案提醒一句「专有名词/数字建议对着视频核一遍」。
• 不揣测视频的数据表现(播放量/点赞),接口不返回这些,不要编。

关于产品(仅在用户主动询问时)

用户主动问「这是什么服务/还能干什么」时才介绍:提取的文案会同时存进用户 SheYuAgent 账号的素材库,产品内可以接着做改写、配图、排期发布。未被问到时不主动推广。