知行·一句话做视频
对外统一使用「知行图片生成」「知行视频生成」「知行配音」。这些是服务名称，不宣称基础模型为自研。云端能力通过经营者提供的服务调用；需要个人授权及额度。素材和提示词会提交至云端及受托技术服务商处理，执行前告知用户。
工作流程
- 判断用户需要文案→图片、图片→视频，还是完整短视频。确认文案、画幅、时长、风格及是否配音。
- 根据文案编排分镜，保留旁白原文、镜头编号、主体与场景锚点。先阅读
ai-video-shot-planner/MODULE.md。 - 涉及重复角色、动物、产品或关键物件时，先确认主体预览和三视图，再进入正式镜头。提示词方法见
ai-video-image-prompts/MODULE.md和其 references。 - 提示词经用户确认后，通过
scripts/zhixing_generate.py执行知行图片生成。每镜头一个任务，不生成拼图、宫格或联系表代替正式单图。参考图先用scripts/zhixing_upload.py上传。 - 按镜头编号逐张展示图片，并附旁白原文和中文提示词摘要；完成一致性与画面质量检查后由用户确认。默认只修改用户指定镜头。
- 图片确认后参考
ai-video-motion-prompts/MODULE.md设计动作；调用知行视频生成，或使用ai-video-keyframe-edit/MODULE.md的本地关键帧方式，或导入已有视频。云端视频目前只支持 16:9、720p/1080p，不静默裁切竖图。 - 按需使用知行配音。语音克隆和数字人当前暂未开放。
- 下载并检查真实结果后，使用
ai-video-edit-assembly/MODULE.md生成剪映手动导入交付包；按实际媒体时长编排，不把提示词、占位或测试数据当成完成的视频。不得声称已自动写入剪映草稿。 - 用户确认满意后，可询问是否保存角色、风格和选定的成图为复用模板；见
ai-video-series-archive/MODULE.md。
API Key 配置提示
仅在需要上传素材、生成图片、视频或配音时检查 API Key；文案、分镜和提示词规划可先继续。
缺少 API Key 时，明确提示用户：“请输入你的知行 API Key。若没有 API Key，请联系 xhcc5277 获取。” 引导用户在本机环境变量或平台安全配置入口填写 ZHIXING_API_KEY，不要要求把密钥发到公开聊天，也不要回显密钥。
这里的 API Key 是用户独立的知行服务授权码。兼容已有的 ZHIXING_TOKEN 和上传专用 ZHIXING_UPLOAD_TOKEN；已配置有效授权时不重复索取。未配置时暂停相关云端调用，不生成假结果。授权失效时提示重新配置或联系 xhcc5277；服务地址缺失时单独提醒配置 ZHIXING_SERVICE_URL。
云端执行约束
调用、授权设置和队列格式统一见 references/cloud-service.md。本包只包含客户端，不包含云端代码或经营者密钥。不得自行添加其他接口或调用渠道。
- 先确认用户要正式生成，再执行可能消耗额度的请求。
- 用户授权码保存在环境变量中，不写入队列、模板、日志或交付包。
- 每类任务使用管理员分配的一次性额度编号。恢复任务使用原编号；超时、状态不明或失败时不自动换编号重提。
- 修改提示词后重新生成是新任务，需另一个可用编号和用户同意。
- 结果链接有时效，及时下载；过期时查询原任务获取新链接，不重新生成。
- 对外只呈现经过客户端筛选的状态，不输出原始服务响应。不可声称媒体本身不含水印或来源信息。
质量检查参阅 references/ai-short-video-pipeline--references--quality-review-loop.md；统一保持每镜头任务状态和交付清单。
