连接 WorkBuddy Expert,从这里开始
网站管理账户、素材、任务结果与用量。Expert 负责规划、生成、剪辑和审阅;单次视频生成返回待审素材,完整交付还需后续制作。
接入前准备好这三项
创建个人 API 密钥,按确认的候选包交接说明准备 Expert,再配置连接器。平台三图原创输入已有本地实现,原创模式默认关闭,生产部署尚未实际验收;是否可用须看实际能力与认证预检。试用包版本和取得方式尚未冻结。
创建 API 密钥- 一个可登录的网站账号和个人 API Key
- 经过确认的 Expert 包交接材料与支持原生凭据输入的宿主
- MCP 地址:https://lampstage.com/api/mcp
从密钥到任务,按顺序完成。
- 01
创建并配置个人 Key
在账户页创建密钥,列表支持复制时可再次复制。不可复制时立即保存新密钥;遗失后需重置,并更新连接器。只在宿主支持的原生凭据或 secret 配置字段填写,不发到聊天。
- 02
分别检查服务与凭据
health / capabilities 是公开接口,不能验证 Key。再携带 Key 请求 GET /api/v1/account/usage,确认认证读取成功;它不生成、不付款,但会计入调用次数。
- 03
确认模式与预算后再生成
按参考视频或三图原创模式准备素材,预检可用性与报价后确认本次预算。单次视频通过 REST 接入;远端 MCP 与客户本地桥是不同连接,本地桥仍待合流和宿主工具发现验收。按已确认交接范围使用,旧制作工具可见不代表可以启动。
任务状态是后续动作的依据
单次视频先保存 request_id,收到响应后保存 id;其他任务保留 job_id。按返回的安全状态与下一步动作查询或恢复原回执。超时、状态未知或查不到时保留原身份核查,不自动换ID重投。相同请求和输入重放不会重复扣款,改动输入会冲突。生成素材仍需本地剪辑、播放、听音与整片审阅。
常见接入问题
API Key 在哪里生成?
登录账户页创建并管理密钥。支持复制的 Key 可再次复制;旧密钥或暂不可复制的 Key 如已遗失,需要重置并立即保存新值。重置会使旧值失效,能否重复复制以列表状态为准。若宿主未出现原生凭据输入入口,先核对连接器声明与宿主版本,不把密钥发到聊天。
一个密钥可以给其他人使用吗?
每个用户使用自己的 Key。泄露后先停用以阻断调用,重置并更新连接器后再按需启用;不再使用的 Key 可删除。Token 额度与调用次数是不同限制:查询及鉴权通过后的业务失败也可能计入次数,无次数上限时异步尽力记录,不是精确账单。
哪些接口无需密钥?
API 发现入口、health 和 capabilities 是公开接口,返回成功不证明 Key 有效。个人用量、任务查询和写入需要 Bearer 鉴权;可用 GET /api/v1/account/usage 做不生成的认证检查。
服务或视频预检不可用怎么办?
health 返回 503 或能力/预检提示不可用时,记录返回原因并暂缓提交,联系平台管理员核查。预检通过也不预留容量或价格;实际提交仍会再次检查。不要切换到旧制作入口绕过限制。
旧视频项目还可以继续制作吗?
当前正式接口关闭旧视频项目的创建、准备、渲染、片段审核、合成与恢复制作操作。已有记录和输出仍可按账户归属读取。新素材使用单次生成接口;旧工具仍在列表中不表示它还能执行。
单次生成完成就是成片交付吗?
不是。单次输出是待本地审阅的视频素材;专家还要检查商品和动作、剪辑拼接、处理声音、完整播放并审阅后交付。缺少可验证输出时不能认定可交付,completed 或一次下载成功也不代表整片质量通过。
可以直接复用以前的分析,或只给产品做视频吗?
参考 v1 需要动作片段和1–6张参考图,可请求4、5、6或8秒;原创 v2 使用恰好3张内容不同的有序图片,可请求5、6或8秒,无需动作视频。平台输入能力不等于专家已能仅凭产品自动交付整片。商品事实→创意脚本→整片制作及跨会话分析复用仍在集成验收,请按已确认范围试用。
预检和生成的费用在哪里核对?
认证预检不生成、不扣 Token,但会计入 Key 调用次数。生成前确认报价与本次 Token 上限;生成后核对稳定账单回执中的已扣、已退和净额,按最新修订更新,不把各次读取的金额累加。缺回执时标为不可用,未知金额不记为0。账户流水已显示服务器核验的任务、调用和退款原扣款标识;确认无关联时显示“无任务关联”,未知或缺失字段显示“关联待核对”,不提供自动跳转或历史补账。0 Token 也不等于生成没有成本。
网站还需要直接操作素材生成吗?
当前产品以 WorkBuddy Expert 与 API 为主要入口。网站用于账户、密钥、资产、任务结果与用量;方案确认、制作和返修由 Expert 承接。
准备好绑定 Expert 了?
从开发者页查看接入约定,或登录账户创建个人 API 密钥。