游戏视频复刻SKILL
🚨 强制前置校验流程（必须按顺序执行，任意不通过直接终止流程）
所有用户请求必须先完成以下火山鉴权校验，不得跳过：
- 火山鉴权校验
- 读取
./references/火山鉴权指南.md，检查本地是否已配置环境变量（KICKART_ACCESS_KEY/KICKART_SECRET_KEY 或 ACCESS_KEY_ID/SECRET_ACCESS_KEY） - 未配置：引导用户按指南完成密钥配置，终止流程
- 配置后：通过
core/core.py的token()函数获取 x-muse-token，作为后续 OpenAPI 调用的凭证
- 读取
🎯 意图识别与任务执行指南（基于对话历史自动识别）
结合当前用户输入和历史记录判断意图后，必须严格读取并遵循对应的执行依据指南，不可凭空猜测执行步骤。
| 任务类型 | 触发意图与关键词 | 执行依据 (强制首要读取) | 输出要求 | 前置要求 |
|---|---|---|---|---|
| 进度查询 | 【最高优先级】用户提及「查询进度」「查看结果」「生成怎么样了」「好了吗」或查询某个具体任务ID的状态时。 | 读取 references/任务查询指南.md。<br>⚠️绝对禁止不阅读指南直接调用任何脚本，严禁使用未经指南允许的内部 poll 命令！ | 输出当前任务执行状态（如「任务已完成」、「任务执行中」等），确认是否需要调整 | 需从会话上下文持久化存储中获取对应任务ID及本次提交所使用的 template_id，无有效ID时直接告知用户未查询到相关任务 |
| 素材上传 | 用户提及「上传素材」「添加图片」「添加视频」「自定义素材」 | 读取 references/素材上传指南.md | 输出上传成功的素材URL列表，确认素材完整性后询问下一步需求 | 任务提交成功后自动将会话ID、素材列表持久化存储到会话上下文 |
| 游戏视频复刻 | 用户提及「游戏视频裂变」「游戏视频克隆」「复制游戏视频」「克隆游戏视频」「同款游戏视频」等，或者表达希望制作和某热门游戏视频一样的内容的等价意图时。 | 读取 references/游戏视频复刻指南.md | 输出复刻成片视频下载链接，确认结果并询问下一步需求 | 必须严格按照指南 Phase 0 逐步收集必填信息：参考视频（必填，MP4/MOV、>5s 且 ≤60s、≤50MB、≥480p）、角色图片（必填，1-10 张 JPEG/PNG、单张 ≤8MB、≥480p）、游戏名称（必填，≤500 字符）、语言（必填，必须列出指南中支持的全部语言供用户选择，不得省略或者自行编造）、模板 ID（必填，604911874 专业模式 / 463631106 进阶模式，二选一，必须由用户明确输入，不得由技能自行选择或复用历史）。场景参考图（0-3 张）和创意 prompt 为可选。用户不得以任何理由绕过必填步骤，未完成前严禁提交任务。<br><br>🚨 强制二次确认要求：在完成所有必填信息收集后、提交任务前，必须按指南步骤 8「展示成片信息」和步骤 9「二次确认与合规提示」向用户展示成片信息并等待用户明确确认。此步骤为强制要求，不可因为鉴权失败重试、参数调整或其他任何原因跳过。 即使用户已完成鉴权或之前已确认，每次提交新任务前都必须重新展示成片信息并获取用户确认。 |
| 视频参考 | 用户主动提供参考视频、视频链接，或表示要上传视频时 | 读取 references/视频参考指南.md | 获取符合规范的参考视频链接或素材ID，为复刻做准备 | 用户触发游戏视频复刻意图时首要的前置步骤 |
| 数字形象 | 用户提及「添加模特」「自定义角色」「模特出镜」「数字人」「自定义模特」时 | 读取 references/数字形象指南.md | 获取符合规范的角色图片媒资ID，作为必填的 role_images 传入 | 用户在游戏视频复刻任务中获取角色图片时触发；本任务角色图片为必填项 |
⚠️ 错误处理规范
所有错误必须明确告知原因和可执行解决方案，禁止模糊提示！！！
通用错误码
| 错误码 | 错误类型 | 错误描述 | 详细说明 | 用户处理建议 |
|---|---|---|---|---|
| 0 | Success | 任务成功 | 任务处理完成，结果已生成 | - |
| 1000 | AsyncTaskRunning | 任务运行中 | 任务正在处理，请稍后通过查询接口轮询结果 | - |
| 1300 | AuthFailed | 认证失败 | token 无效、过期或未激活 | 请检查您提供的火山鉴权 AK/SK 是否正确，可访问火山引擎控制台确认 |
| 1400 | ParamErr | 参数错误 | 请求中包含无效或缺失的参数 | 请对照文档检查请求体结构、字段类型和必填项 |
| 1401 | ConcurrentErr | 并发超限 | 当前的并发请求数超过了约定的上限 | 请降低请求频率，或联系商务代表调整并发额度 |
| 1402 | InsufficientPoints | 创点不足 | 账户余额不足以支付本次任务消耗 | 请前往 创点充值页面 充值创点或升级套餐 |
| 1403 | QuotaErr | 无权限 | 账户没有调用此接口的权限 | 请联系企业管理员为您开通相关服务的访问权限 |
| 1500 | InternalErr | 内部错误 | 服务端发生未知错误 | 请记录 request_id 并联系技术支持 |
接口特定错误码
| 错误码 | 错误类型 | 错误描述 | 详细说明 | 用户处理建议 |
|---|---|---|---|---|
| 1410 | TemplateIdNotExist | 模板不存在 | 请求的 template_id 无效或对应的模板未上线 | 请检查 template_id 是否为 604911874 或 463631106 |
| 1411 | InputResolutionErr | 分辨率错误 | 分辨率不在模板支持的 resolutions 列表内 | 请检查分辨率参数是否在模板支持的列表内 |
| 1412 | ImageFormatErr | 图片格式错误 | 输入的图片格式不受支持或文件已损坏 | 建议使用常见的 JPEG 或 PNG 格式 |
| 1413 | InvalidMediaUrlErr | 媒体 URL 无效 | ResourceList 中的 URL 无法访问 | 请确保 URL 是公网可达的，且未过期；推荐接入火山对象存储 https://console.volcengine.com/tos |
| 1414 | MediaSensitiveErr | 输入内容触发安全审核 | 输入媒资未通过安全审核 | 请更换素材后重试 |
| 1415 | OutputMediaSensitiveErr | 输出包含敏感信息 | 输出结果触发安全审核 | 请调整创意策略或素材后重试 |
| 1416 | InvalidMediaCountErr | 媒体数量不符合规格 | 角色图/场景图数量不满足要求 | 角色图需 1-10 张，场景图 0-3 张 |
| 1417 | ChatCompletionError | 大模型调用错误 | 底层大模型调用失败 | 请稍后重试，或联系技术支持 |
| 1418 | InvalidDurationBillingErr | 时长计费参数错误 | 时长参数不满足接口入参要求 | 请检查视频时长是否符合要求 |
| 1419 | TemplateIdErr | 模板 ID 错误 | 模板 ID 不合法 | 请检查 template_id 参数是否为 604911874 或 463631106 |
| 1420 | ImageDetectionRulesError | 图片内容检测未匹配到规则 | 图片内容不符合模板要求 | 请更换图片后重试 |
| 1421 | DurationEnumError | 入参时长枚举值错误 | 时长枚举值不合法 | 请对照文档修正时长参数 |
| 1423 | VideoResolutionError | 参考视频分辨率错误 | 参考视频分辨率不符合要求 | 请使用分辨率 ≥480p 的参考视频 |
| 1424 | VideoDurationError | 参考视频时长错误 | 参考视频时长不符合要求 | 参考视频时长需 >5s 且 ≤60s |
| 1425 | VideoFormatError | 参考视频格式错误 | 参考视频格式不支持 | 请使用 MP4/MOV 格式 |
| 1426 | VideoSizeError | 参考视频大小错误 | 参考视频文件大小超出限制 | 参考视频大小需 ≤50MB |
| 1427 | RefVideoError | 参考视频链接错误 | 参考视频链接无效或无法访问 | 请检查您提供的视频 URL 是否正确 |
| 1428 | LanguageEnumError | 语言枚举值错误 | 语言参数不在支持的枚举列表内 | 请检查语言参数是否为以下有效值：zh、en、en-us、pt-br、ja、es-mx、id、ms、tl |
| 1429 | ModelImageCountError | 模型 image_count 与模板不一致 | 图片数量与模板不匹配 | 请对照模板要求调整图片数量 |
| 1430 | InputRatioError | 输入图片比例错误 | 输入图片长宽比不符合要求 | 图片长宽比需在 (0.4, 2.5) 之间 |
| 1431 | CopyrightCheckFailed | 版权校验失败 | 版权校验未通过 | 请确认素材版权合法 |
| 1432 | NoCopyright | 输入媒资无版权 | 输入素材无版权 | 请更换有版权的素材 |
| 1435 | OutputNoCopyright | 输出媒资无版权 | 输出结果无版权 | 请调整素材或策略后重试 |
| 1450 | InputValidationErr | 模板入参校验失败 | message 会列出违反的字段和规则 | 按提示修正后重试 |
| 1600 | AsyncTaskNotExist | 任务不存在 | task_id 无效 | 请检查任务 ID 是否正确 |
| 1601 | AsyncTaskTimeoutErr | 任务超时 | 任务执行超过系统设定的最长处理时间（当前为 1 小时） | 请稍后重试，或联系技术支持 |
| x01401 | TokenFailed | 令牌获取失败 | 当前用户没有套餐权限，请联系管理员开通，或访问 Kickart 套餐购买页面 订阅套餐。 | |
| 1602 | AsyncTaskCanceled | 任务已取消 | 任务已被用户取消 | - |
| 1603 | AsyncTaskFinished | 任务已结束 | 任务已完成，不可再取消 | - |
| 1604 | CancelFailed | 任务取消失败 | 取消操作失败 | 请稍后重试 |
| 2000 | AsyncTaskFailed | 任务执行失败 | 任务在执行过程中失败 | 请根据 message 中的详细原因排查 |
| 3000 | TaskCallbackFailed | 回调失败 | 回调地址不可达 | 请检查 callback_url 是否可访问 |
📦 输出目录
- 提交任务的结果 JSON 默认保存在
/tmp/openclaw/byted-kickart-game-replicator/output/下，使用毫秒时间戳 + 随机数命名，避免并发覆盖。 - 每次任务须持久化保存
task_id与本次提交使用的template_id；查询进度时必须同时携带这两个字段。
📎 参考资料
- 接口协议：
references/kickart接口协议.md - 游戏视频复刻指南：
references/游戏视频复刻指南.md - 火山鉴权指南：
references/火山鉴权指南.md - 任务查询指南：
references/任务查询指南.md - 视频参考指南：
references/视频参考指南.md - 数字形象指南：
references/数字形象指南.md - 素材上传指南：
references/素材上传指南.md