byted-kickart-game-replicator

# 游戏视频复刻SKILL ## 🚨 强制前置校验流程（必须按顺序执行，任意不通过直接终止流程） 所有用户请求必须先完成以下火山鉴权校验，不得跳过： 1. **火山鉴权校验** - 读取`./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 是否正确，可访问[火山引擎控制台](https://console.volcengine.com/iam/keymanage)确认 | | 1400 | ParamErr | 参数错误 | 请求中包含无效或缺失的参数 | 请对照文档检查请求体结构、字段类型和必填项 | | 1401 | ConcurrentErr | 并发超限 | 当前的并发请求数超过了约定的上限 | 请降低请求频率，或联系商务代表调整并发额度 | | 1402 | InsufficientPoints | 创点不足 | 账户余额不足以支付本次任务消耗 | 请前往 [创点充值页面](https://console.volcengine.com/kickart/fusion/setting/combobuy?tab=additionalCombo) 充值创点或升级套餐 | | 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 套餐购买页面](https://console.volcengine.com/kickart/fusion/setting/combobuy?tab=additionalCombo) 订阅套餐。 | | 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`