所有用户请求必须先完成以下4步校验，不得跳过：
./references/火山鉴权指南.md，检查本地是否已配置环境变量./references/套餐开通指南.md，调用套餐查询接口检查用户套餐是否在有效期内、创点余额充足结合当前用户输入和历史记录判断意图后，必须严格读取并遵循对应的执行依据指南，不可凭空猜测执行步骤。
| 任务类型 | 触发意图与关键词 | 执行依据 (强制首要读取) | 输出要求 | 前置要求 |
|---|---|---|---|---|
| --------- | ---------------- | ---------------------- | --------- | --------- |
| 进度查询 | 【最高优先级】用户提及「查询进度」「查看结果」「生成怎么样了」「好了吗」或查询某个具体任务ID的状态时。 | 读取 references/任务查询指南.md。⚠️绝对禁止不阅读指南直接调用任何脚本，严禁使用未经指南允许的内部 poll 命令！ | 输出当前任务执行状态（如「任务已完成」、「任务执行中」等），确认是否需要调整 | 需从会话上下文持久化存储中获取对应任务ID，无有效ID时直接告知用户未查询到相关任务 |
| 素材上传 | 用户提及「上传素材」「添加图片」「添加视频」「自定义素材」 | 读取 references/素材上传指南.md | 输出上传成功的素材URL列表，确认素材完整性后询问下一步需求 | 任务提交成功后自动将会话ID、素材列表持久化存储到会话上下文 |
| 素材分析 | 用户提及「素材分析」「分析商品」「拉取素材」或者直接发送「抖音商品详情链接」 | 读取 references/素材分析指南.md | 输出商品主图/详情图/视频数量、核心卖点、基础商品信息，确认结果准确性后询问下一步需求 | 任务提交成功后自动将Task ID持久化存储到会话上下文 |
| 创意分析 | 用户提及「创意分析」「卖点分析」「受众分析」「创作方向」 | 读取 references/创意分析指南.md | 输出目标受众、推荐视频规格、核心卖点提炼、创意方向建议，确认结果准确性后询问下一步需求 | 任务提交成功后自动将Task ID持久化存储到会话上下文 |
| 爆款裂变 | 用户提及「爆款复刻」「爆款裂变」「爆款克隆」「复制视频」「克隆视频」「同款视频」「生成同款」「裂变视频」等，或者表达希望制作和某热门视频一样的内容的等价意图时。 | 读取 references/爆款裂变指南.md | 输出裂变成片视频下载链接，确认结果并询问下一步需求 | 需要先完成创意分析，获取创意分析结果文件路径，以及用户提供的参考视频 |
| 视频参考 | 用户主动提供参考视频、视频链接，或表示要上传视频时 | 读取 references/视频参考指南.md | 获取符合规范的参考视频链接或素材ID，为裂变做准备 | 用户触发爆款裂变意图时首要的前置步骤 |
| 数字形象 | 用户提及「添加模特」「自定义角色」「模特出镜」「数字人」「自定义模特」时 | 读取 references/数字形象指南.md | 获取符合规范的角色图片媒资ID，为裂变提供自定义模特 | 用户在裂变任务中需要指定角色出镜时触发 |
所有错误必须明确告知原因和可执行解决方案，禁止模糊提示！！！
| 错误码 | 错误描述 | 详细说明 | 用户处理建议 | |
|---|---|---|---|---|
| --- | --- | --- | --- | |
| 0 | 无返回值 | 接口调用成功，但服务返回结果为空 | 请稍后重试，如问题持续请联系火山技术支持 | |
| 1400 | ParamErr参数错误 | 参数错误 | 联系技术支持 | |
| 1402 | 创点不足 | 调用接口时，用户账户的创点额度不足 | 请前往 创点充值页面 充值创点或升级套餐 | |
| 1410 | 服务ID不存在 | 调用接口时，输入参数中包含了不存在的服务ID | 升级SKILL | |
| 1411 | 输入分辨率错误 | 调用接口时，输入参数中的图片或视频分辨率不符合要求 | 请检查素材分辨率是否符合规格要求（如≥480p） | |
| 1412 | 图片格式错误 | 调用接口时，输入参数中包含了非支持的图片格式 | 请检查图片格式是否为 jpg、png 等支持的格式 | |
| 1413 | 无效的媒体URL错误 | 调用接口时，输入参数中包含了无效的媒体URL | 请检查您提供的URL是否正确，避免包含特殊字符或格式错误 | |
| 1414 | 输入包含敏感信息错误 | 调用接口时，输入参数中包含了敏感信息，如个人隐私数据等 | 暂不可生成带人物的营销视频，请等待后续版本更新 | |
| 1415 | 输出包含敏感信息错误 | 调用接口时，服务返回结果中包含了敏感信息，如个人隐私数据等 | 暂不可生成带人物的营销视频，请等待后续版本更新 | |
| 1416 | 输入媒体数量错误 | 用户输入的素材数量超过限制 | 提供的媒体素材数量超出限制，多出的素材可能不会使用 | |
| 1417 | 大模型调用错误 | 模型调用出错，通常是输入参数错误 | 媒体素材处理存在问题，请重新尝试，如问题持续请联系火山技术支持 | |
| 1418 | 时长计费参数错误 | 提交时入参时间有问题 | 要求的成片时长不符合技能要求，请按照0-60s的时长限制提交制作需求，如问题持续请联系火山技术支持 | |
| 1501 | 用户套餐过期 | 调用接口时，用户套餐已过期 | 请前往 套餐开通页面 开通套餐 | |
| 100010 | 签名验证失败 | AK/SK签名验证失败 | 请检查您提供的火山鉴权AK/SK是否正确，可访问火山引擎控制台确认 | |
| 100013 | 缺少服务权限 | 缺少iccloud\_muse服务的RegisterArkClawCombo权限 | 您的企业账号未开通Kickart权限，请联系火山主账号管理员为您开通，或详询火山技术支持 | |
| x01001 | AK/SK未配置 | 用户未配置AK/SK | 请输入火山鉴权的AK/SK，可访问火山引擎控制台获取 | |
| x01010 | 有效套餐缺失 | 素材上传出现错误，通常是套餐原因 | 请前往 套餐开通页面 开通套餐 | |
| A0101 | Session元数据格式错误 | 接口传入的Session元数据格式错误 | 根据 references/消费成片指南.md 校验当前主会话，确保传入的Session元数据格式正确 | |
| 其他 | \- | 未明确列出的其他错误情况 | 稍后重试，如问题持续请联系火山技术支持 |
共 1 个版本