把你的业务 API 接入 WorkBuddy Expert

参考 v1：输入 motion_asset_id、1–6 个有序 reference_assets（每项含 asset_id，可附 role、label）、prompt 和 duration（4、5、6 或 8 秒）。动作片段与参考图须归当前账户；v1 请求不附 input_contract 或 mode。返回的输入标识为 video-call-input@1 / reference_video。

原创 v2：输入 input_contract=video-call-input@2、mode=original_images、恰好3张有序 reference_assets、prompt 和 duration（5、6 或 8 秒）。三图须归当前账户，asset_id 和实际图片内容均不能重复，每项可附 role、label；不传 motion_asset_id 或 motion，也不需要伪造动作视频。

preview 只接收对应模式的素材参数，不接受 request_id、max_credits 或 review_binding。原创素材校验成功后返回各图实测 sha256、顺序及 frozen_input_digest；校验失败时这些字段可能缺失。核对 available、reasons 与 quote；预检不生成、不扣 Token，只反映当前条件，不预留容量或价格。

原创创建额外需要 review_binding，精确包含 version=1、project_id、revision_id、script_digest、plan_digest、frozen_input_digest。将已审脚本/计划的SHA-256与预检冻结摘要绑定到该项目修订；摘要为64位小写十六进制。平台校验字段和绑定一致性，不代替脚本、计划及素材的语义审稿。

需要复算原创冻结摘要时，按 domain、input_contract、mode、reference_assets、prompt、duration 的顺序构造对象，domain 为 video-call-frozen-input@2；各参考项按 asset_id、sha256、可选 role、可选 label 排列。保留图片顺序与原文，省略未提供的可选项，对 JSON.stringify 结果的 UTF-8 字节计算 SHA-256。该摘要不包含 request_id、max_credits、review_binding；不能按请求对象的任意属性顺序散列。

正式提交保留预检素材参数，增加 request_id 与 max_credits，原创另带上述 review_binding。先保存请求身份，收到响应后保存 id；预算上限为本次明确同意的平台 Token。相同账户、request_id 和完整输入重放返回原调用，不重复扣款；模式、参考顺序、审核绑定或预算等变化会产生409冲突。新版本需新的身份与预算确认，不能用于绕过未决请求。

两种输入的任务响应均使用 contract_version=video-call@2。按 execution.code、reason_code、next_action 和 poll_after_seconds 决定后续动作，不从 stage/error 文案猜权限。超时或受理不明时先按原 request_id 查询，再用 id 跟踪；unknown、manual_review 或404不证明从未受理，不自动换ID重投。仅 next_action=reconcile 时恢复原回执；call_busy 继续查原调用，不重复生成。

经验证的输出位于 output：kind=generated_clip、review_state=pending_local_review，并含 url、download_url、sha256、size_bytes、mime 和 media。通过返回地址取回素材并核对字节与实测信息；fps、frame_count、has_audio 当前为null，不能推算。output 缺失时不可认定可交付；completed 也不替代整片剪辑、完整播放、听音与本地审阅。

费用以 billing_receipt 为准：保存稳定 id 与 revision，核对 state、charged、refunded、net、debit_id、refund_id；unit=platform_credits 在界面显示为 Token。按同一 id 的 revision 更新事实，不将重复读取或新修订的金额再次累计。缺失或不一致时 billing_receipt_status=unavailable，unknown 金额保持null，不记为0。旧 billing、output_url 等仅兼容读取，不充当新结算依据。账户流水已能显示服务器核验的任务、调用及退款原扣款标识；缺失关联保持中性，不提供自动跳转或历史补账。

旧 video-jobs 的创建、prepare、render、review、assemble、reconcile 制作操作在正式模式下关闭，对应旧 MCP 制作工具也受此限制。历史记录与已有输出可按归属读取；工具名或旧任务可见不代表可继续制作。